Mode d’emploi
- Collez du JSON, ouvrez un fichier ou essayez l’exemple.
- Ajustez les réglages. Le résultat se met à jour pendant la saisie.
- Copiez ou téléchargez le résultat formaté.
Comprendre le JSON
JSON est un format texte d’échange de données structurées. Vous le rencontrerez souvent dans les réponses d’API, les fichiers de configuration et les enregistrements exportés. Son petit ensemble de types de valeurs facilite le transfert de données entre différents langages de programmation.
Le formatage rend cette structure plus facile à examiner. L’indentation indique quelles valeurs vont ensemble ; les sauts de ligne facilitent la lecture des enregistrements imbriqués. Ces choix de présentation ne changent pas les données représentées par un document valide.
Valeurs et structure
Un document JSON contient une valeur. Cette valeur peut être un objet ou un tableau, mais une chaîne, un nombre, un booléen ou null est également valide à la racine. Les objets associent des noms sous forme de chaînes à des valeurs ; les tableaux contiennent des valeurs dans un ordre significatif. Les deux peuvent être imbriqués.
| Type | Exemple | Signification |
|---|---|---|
| Objet | {"name": "Ada"} | Propriétés nommées entre accolades. |
| Tableau | ["red", "blue"] | Une séquence ordonnée entre crochets. |
| Chaîne | "Hello, world" | Texte entre guillemets doubles. |
| Nombre | -12.5e2 | Un nombre décimal, éventuellement avec un exposant. |
| Booléen | true / false | L’une des deux valeurs logiques. |
| Valeur nulle | null | Une valeur nulle explicite, pas une propriété omise. |
La syntaxe à respecter
Utilisez des guillemets doubles pour les noms de propriétés et les chaînes. Un deux-points sépare un nom de sa valeur ; des virgules séparent les membres d’un objet et les éléments d’un tableau. N’ajoutez pas de virgule après le dernier membre ou élément. Les commentaires, les guillemets simples et les expressions JavaScript ne font pas partie du JSON strict.
Les littéraux true, false et null s’écrivent en minuscules. Les nombres utilisent une notation décimale avec un signe moins, une partie fractionnaire et un exposant facultatifs. Les zéros initiaux, le signe plus initial, NaN et Infinity sont invalides. Dans les chaînes, échappez les guillemets, les barres obliques inverses et les caractères de contrôle ; un saut de ligne doit être écrit avec une séquence d’échappement telle que \n.
Les noms d’un objet devraient être uniques pour garantir des échanges fiables. Différents programmes peuvent conserver des valeurs différentes lorsque les noms se répètent. Le formateur signale les doublons et les conserve pour vous laisser décider comment les résoudre. Une vérification syntaxique seule ne confirme pas qu’un document respecte un contrat d’API ou JSON Schema.
Ce que le formatage préserve
DevToolsy valide l’entrée et ajuste les espaces blancs autour des tokens d’origine. Il conserve l’écriture des nombres comme 900719925474099312345, 19.9900, 1e+400 et -0, ainsi que les séquences d’échappement d’origine. Cela évite les arrondis dus à l’analyse puis à la resérialisation des nombres sous forme de valeurs à virgule flottante JavaScript. L’application qui lit le résultat détermine toujours sa propre précision numérique.
L’indentation, les fins de ligne LF ou CRLF et le saut de ligne final sont des conventions de sortie. Trier les clés est une modification distincte et facultative : les membres des objets sont triés récursivement selon leurs noms décodés, avec une comparaison déterministe sensible à la casse. L’ordre des tableaux et l’ordre relatif des noms en double restent intacts. Ce tri facilite la lecture et les comparaisons ; ce n’est pas un mécanisme de canonisation pour les signatures cryptographiques.
{"name":"Ada","roles":["developer","reviewer"],"active":true}{
"name": "Ada",
"roles": [
"developer",
"reviewer"
],
"active": true
}L’indentation change la présentation. Les noms de propriétés, les valeurs et l’ordre des tableaux restent identiques.
Jusqu’à 5 MiB d’entrée UTF-8, 20 MiB de sortie, 128 niveaux d’imbrication, 250 000 tokens analysés et 10 secondes par exécution. Les documents volumineux peuvent nécessiter un appareil plus puissant.
Questions fréquentes
Le formatage automatique modifie-t-il mon entrée ?
Non. Il met à jour le résultat en lecture seule après une courte pause et laisse l’entrée telle que vous l’avez écrite. Le formatage automatique est activé au départ. Désactivez-le pour lancer manuellement avec Formater le JSON ou Ctrl/⌘ + Enter.
Que se passe-t-il tant que mon JSON est incomplet ?
Le dernier résultat valide reste visible pendant la modification. Copier et Télécharger sont désactivés tant que l’entrée et les réglages actuels ne produisent pas un résultat valide. Sélectionnez une erreur pour accéder à sa position dans l’entrée.
Le formatage arrondit-il les grands nombres ou modifie-t-il les séquences d’échappement ?
Non. Les tokens numériques d’origine et l’écriture des séquences d’échappement sont préservés. Cela comprend les grands entiers, les zéros décimaux finaux, la notation exponentielle et le zéro négatif. D’autres applications peuvent interpréter ces nombres avec une précision différente.
Le tri des clés réorganise-t-il aussi les tableaux ?
Non. Trier les clés s’applique récursivement aux objets uniquement. Les tableaux gardent leur séquence et les noms en double leur ordre relatif. Le tri est désactivé par défaut.
Le formateur peut-il corriger les commentaires ou les virgules finales ?
Il accepte le JSON strict et signale les syntaxes invalides plutôt que de deviner une correction. Les commentaires, les chaînes entre guillemets simples, les clés sans guillemets et les virgules finales doivent être corrigés dans l’entrée.
JSON Beautifier et JSON Formatter désignent-ils la même chose ?
Oui. Sur cette page, embellir, pretty-print et formater signifient ajouter au JSON une indentation et des sauts de ligne pour le rendre lisible. Pour un document compact, utilisez le Minificateur JSON.
Mon JSON quitte-t-il mon appareil ?
Le texte collé et les fichiers locaux sont traités dans votre navigateur. DevToolsy ne téléverse pas votre JSON et ne conserve pas d’historique des documents. Copiez ou téléchargez le résultat avant de partir si vous souhaitez le garder.