Validateur et embellisseur JSON

Le Validateur et embellisseur JSON est un outil gratuit qui vérifie la validité syntaxique du JSON et met en forme le contenu valide pour en faciliter la lecture.

À quoi servent la validation et l'embellissement du JSON ?

La validation vérifie que le contenu respecte la grammaire JSON, tandis que l'embellissement présente les objets et les tableaux valides avec un espacement et une indentation cohérents. Ces opérations sont utiles pour déboguer les réponses d'une API, vérifier une configuration avant son déploiement ou lire des données compactes fournies par un tiers.

La syntaxe JSON est plus stricte que celle d'un littéral d'objet JavaScript. Les noms de propriétés doivent être entourés de guillemets doubles, les chaînes ne peuvent pas utiliser d'apostrophes et les objets comme les tableaux ne doivent pas contenir de virgule finale. Les commentaires, undefined, NaN et Infinity ne font pas non plus partie de la spécification JSON.

Cet outil utilise la fonction PHP json_decode sur le serveur. Ton contenu est transmis au serveur via HTTPS et n'est pas stocké. Il quitte toutefois ton appareil. Masque donc les mots de passe, les jetons d'accès et les données personnelles si les règles de traitement de ton organisation n'autorisent pas leur envoi à un serveur externe.

Comment valider et embellir du JSON ?

Colle le contenu dans le champ JSON, puis lance l'outil. Pour obtenir un résultat utile, fournis une valeur JSON complète plutôt qu'une partie d'objet copiée depuis une ligne de journal.

1. Copie la réponse brute, le bloc de configuration ou toute autre valeur JSON sans les libellés affichés autour dans la console.
2. Colle le contenu dans le champ JSON en conservant les guillemets et les caractères d'échappement.
3. Lance la validation, puis examine le résultat mis en forme ou l'erreur signalée.
4. Si la validation échoue, corrige le premier problème de syntaxe apparent et relance l'outil. Un seul guillemet manquant peut entraîner une mauvaise interprétation de plusieurs caractères qui suivent.

Les quatre caractères d'espacement autorisés entre les éléments JSON, l'espace (U+0020), la tabulation (U+0009), le saut de ligne (U+000A) et le retour chariot (U+000D), n'ont aucune incidence. Ils peuvent donc être ajoutés ou supprimés sans modifier les données. En revanche, les espaces situés dans une chaîne entre guillemets font partie des données et doivent rester inchangés. La ponctuation contenue dans les chaînes est également préservée, même si les guillemets, les barres obliques inverses et les caractères de contrôle nécessitent la séquence d'échappement appropriée.

Comment interpréter le résultat de la validation ?

Un résultat positif signifie que PHP a pu décoder le contenu comme du JSON. Un échec indique que l'analyseur n'a pas pu l'interpréter comme une valeur JSON complète et valide. L'embellissement rend ensuite visibles l'imbrication et les limites des objets et tableaux valides.

Les causes d'échec les plus courantes sont les suivantes :

• une virgule finale avant } ou ] ;
• un nom de propriété sans guillemets, comme {name: "Ada"} ;
• des chaînes entourées d'apostrophes ;
• une virgule manquante entre des propriétés ou des éléments de tableau ;
• un guillemet double ou une barre oblique inverse non échappés dans une chaîne ;
• un objet, un tableau ou une chaîne incomplets ;
• un contenu UTF-8 non valide ou un caractère de contrôle brut dans une chaîne ;
• une partie entière comportant des zéros initiaux superflus, comme 01 ou -01, ou des valeurs non conformes au JSON telles que NaN.

Un champ vide n'est pas du JSON valide. À l'inverse, une valeur isolée comme 42, true, null ou "hello" constitue du JSON valide, même s'il ne s'agit ni d'un objet ni d'un tableau. Un contenu imbriqué à une profondeur très importante peut également dépasser la limite d'imbrication du décodeur.

La validation syntaxique ne confirme pas que les données respectent le contrat d'une API. Un document peut être un JSON valide tout en contenant une chaîne là où une application attend un nombre, en omettant une propriété obligatoire ou en utilisant un format de date non accepté. Pour vérifier ces exigences, utilise JSON Schema ou des contrôles au niveau de l'application.

Exemples pratiques de JSON

Contenu compact valide :

{"name":"Ada","active":true,"roles":["admin","editor"]}

Le résultat embelli présente les propriétés et les éléments du tableau sur des lignes distinctes, avec plusieurs niveaux d'indentation. Les valeurs restent respectivement une chaîne, un booléen et un tableau. La mise en forme modifie la présentation, pas les types de données sous-jacents.

Contenu non valide avec une virgule finale :

{"name":"Ada","active":true,}

La validation échoue, car le JSON n'autorise pas de virgule après la dernière propriété. Supprime cette virgule pour rendre l'objet valide.

Les caractères accentués et les textes utilisant d'autres alphabets peuvent figurer directement dans les chaînes JSON lorsque le contenu est encodé en UTF-8 valide. Par exemple, {"city":"Zürich","greeting":"こんにちは"} est valide. La notation d'échappement JSON telle que \u00fc offre une autre représentation valide de certains caractères Unicode. Des paires de substitution sont toutefois nécessaires pour les caractères situés hors du plan multilingue de base.

Quand l'embellissement du JSON est-il inutile ?

L'embellissement n'est pas nécessaire si le JSON est uniquement destiné à être lu par une machine et qu'aucune vérification humaine ni revue dans un système de gestion de versions n'est prévue. L'indentation et les sauts de ligne supplémentaires augmentent le nombre d'octets transférés. Les réponses de production sont donc généralement envoyées sous une forme compacte.

Minifier du JSON déjà compact présente également peu d'intérêt. Des minifications successives ne peuvent pas raccourcir davantage les noms de propriétés fixes ni les valeurs des chaînes, et modifier ces valeurs changerait les données. Pour du JavaScript destiné au déploiement plutôt que pour des données JSON, le Minificateur JS est plus approprié.

L'embellissement est surtout utile pour examiner les structures ou les valeurs JSON pendant un débogage, une revue de code ou des vérifications avant déploiement. Il permet de repérer les incohérences d'imbrication, facilite le parcours de grands tableaux et produit des différences plus lisibles lorsqu'une configuration est enregistrée dans Git. Il ne répare pas automatiquement un JSON mal formé et ne détermine pas le sens qui devait être donné à un fragment ambigu.

Questions fréquentes

Peut-on ajouter des commentaires dans du JSON ?

Non. Le JSON standard ne définit aucune syntaxe de commentaire. // comment et /* comment */ font donc échouer la validation. Si un fichier de configuration doit contenir des commentaires, utilise un format qui les prend en charge ou supprime-les avant de transmettre le contenu à un analyseur JSON strict.

Les noms de propriétés en double sont-ils rejetés ?

Pas nécessairement. Selon la spécification JSON, les noms des membres d'un objet devraient être uniques, mais les analyseurs ne considèrent pas toujours les doublons comme une erreur de syntaxe. Le décodage PHP conserve généralement la dernière valeur. Si chaque occurrence doit être préservée, détecte donc les doublons avant la validation.

Peut-on valider un fichier JSON Lines ?

Pas comme un document JSON unique. Le format JSON Lines, également appelé NDJSON, contient une valeur JSON distincte sur chaque ligne, tandis qu'un analyseur JSON classique attend une seule valeur de premier niveau. Valide chaque ligne séparément ou convertis les enregistrements en un seul tableau JSON.

L'ordre des propriétés d'un objet JSON est-il important ?

Les applications ne doivent pas dépendre de l'ordre des propriétés d'un objet JSON. Les tableaux sont ordonnés, mais les objets représentent des collections de membres nommés. Un autre analyseur ou sérialiseur peut restituer ces membres dans un ordre différent. Si l'ordre a une signification, place les valeurs dans un tableau.

Pourquoi un fichier JSON échoue-t-il alors qu'il semble correct ?

Une marque d'ordre des octets invisible, un encodage UTF-8 incorrect ou un caractère de contrôle non échappé peut rendre invalide un texte qui semble pourtant correct. Une copie effectuée depuis un terminal peut aussi introduire des préfixes, comme des libellés d'état ou des horodatages. Examine les octets bruts ou ouvre le fichier dans un éditeur capable d'afficher l'encodage et les caractères de contrôle.

Dernières vérifications

Avant de déployer le JSON corrigé, compare les types de données ainsi que les valeurs visibles, vérifie que les séquences d'échappement n'ont pas changé, puis exécute l'application qui utilisera les données ou son outil de validation de schéma. Lorsque tu analyses des données provenant d'un tiers, conserve une copie intacte de la réponse d'origine afin que la mise en forme ne masque pas la source du problème.