YamlBox

JSON outils · 6 minutes de lecture

Formateur JSON : joli, minifié et réellement valide

Un formateur JSON effectue trois tâches, et il est utile de savoir laquelle vous avez réellement besoin : il rend le JSON dense lisible, il rend le JSON lisible compact et il vous indique exactement où un fichier a cessé d'être valide JSON. La plupart des gens font appel à un formateur parce que quelque chose est cassé – et le message d'erreur, et non la jolie impression, est la partie qui sauve l'après-midi.

Mis à jour

Pretty-print : pour les humains et les pull request

L'indenté JSON est révisable JSON. Deux espaces sont la convention dans la plupart des bases de code JavaScript et correspondent à la valeur par défaut dans `JSON.stringify(value, null, 2)` ; quatre espaces conviennent aux éditeurs configurés de cette façon. Le choix de formatage importe moins que la cohérence, car l'indentation mixte transforme chaque différence ultérieure en bruit. Si votre JSON est généré, définissez une fois l'indentation dans le générateur et laissez le formateur l'appliquer localement pour les charges utiles collées.

Minify : pour les charges utiles sur le fil

Les espaces dans JSON sont facultatifs, donc les supprimer constitue une économie gratuite. Sur une réponse API de 200 Ko, la différence est généralement de 15 à 30 % des octets, ce qui est important lorsque le budget concerne une connexion mobile ou un en-tête de cache que vous essayez de respecter. La réduction est également la bonne décision avant de stocker une charge utile dans une colonne de base de données ou de l'intégrer dans un URL — il suffit de réduire la taille comme une étape de construction plutôt que manuellement, car la minification manuelle JSON est l'endroit où le débogage va mourir.

Validation : les erreurs que vous rencontrerez réellement

JSON est une grammaire volontairement petite, c'est pourquoi ses erreurs sont si répétitives. Presque toutes les erreurs JSON invalides remontent à l'une des cinq habitudes tirées de JavaScript ou YAML :

  • Virgules finales — `{"a": 1,}` est un JavaScript valide et un JSON non valide.
  • Guillemets simples ou clés sans guillemets — `{a: 'b'}` doit devenir `{"a": "b"}`.
  • Commentaires — `// note` et `/* note */` n'ont pas du tout leur place dans JSON.
  • Caractères de contrôle sans échappement — les nouvelles lignes littérales à l'intérieur d'une chaîne doivent être `\n`.
  • Objets concaténés : deux objets de niveau supérieur côte à côte, généralement issus d'un fichier journal avec un document JSON par ligne.

Un formateur doit vous indiquer la ligne, la colonne et afficher l'extrait. « Jeton inattendu » à lui seul vous laisse faire défiler ; "ligne 84, colonne 17 - virgule finale avant }" est un correctif.

Pourquoi valider avant de déboguer

Lorsqu'une intégration échoue, l'instinct est d'inspecter le code. Le plus souvent, la charge utile elle-même est mal formée : un modèle a émis une virgule parasite, un pipeline de journaux a tronqué une ligne ou un copier-coller d'un document a introduit des guillemets intelligents. L'exécution du formateur JSON sépare d'abord « les données sont fausses » de « le code est faux » en quelques secondes, et le numéro de ligne exact pointe généralement directement vers le modèle qui l'a produit.

Fichiers volumineux et confidentialité

Les réponses API et les exportations de bases de données contiennent fréquemment des jetons, des champs personnels ou des données client. Un formateur JSON côté serveur signifie télécharger cette charge utile à un tiers pour la récupérer – une question de protection des données sans avantage, puisque le formatage est une opération locale triviale. Le formateur YamlBox JSON analyse dans le navigateur sans appels réseau, il fonctionne donc hors ligne et conserve votre charge utile sur votre machine ; la même page vous propose des choix d'indentation, un tri par clé pour des différences stables et des statistiques en direct telles que la profondeur et le nombre de clés.

JSON Formateur — questions fréquemment posées

Quelle est la différence entre formater et valider JSON ?

Le formatage ne modifie que les espaces et est toujours sûr une fois le document analysé. La validation est la vérification qu'il analyse - un formateur qui ne peut pas analyser votre entrée signalera une ligne et une colonne au lieu de produire une sortie, et ce rapport est la partie utile.

De combien la taille JSON est-elle réduite ?

Généralement 15 à 30 pour cent, en fonction de la profondeur d'imbrication du document et de la longueur des clés. La minification se fait sans perte : les espaces entre les jetons n'ont aucune signification dans JSON, donc un document minifié est analysé avec exactement la même valeur.

Est-il sécuritaire de formater des fichiers JSON contenant des secrets dans le navigateur ?

Oui, lorsque le formateur s'exécute entièrement côté client. Il n'y a pas de téléchargement ni de demande vers un serveur, donc les jetons de la charge utile restent dans votre onglet - et la page continue de fonctionner lorsque le réseau est éteint, ce que vous pouvez vérifier vous-même.

Outils mentionnés dans cet article

Parcourez la liste complète des 19 outils

Plus d'articles à lire

6 minutes de lecture

JSON diff : comparer les données telles qu'elles sont

Comparez deux charges utiles JSON avec une différence structurelle JSON qui ignore l'ordre des clés et les espaces, met en évidence les valeurs déplacées et montre pourquoi les différences de texte induisent en erreur.

Tous les 19 messages →