Comment trier les clés JSON par ordre alphabétique en ligne (objets imbriqués compris)
Triez les clés JSON par ordre alphabétique en ligne, à tous les niveaux ou au premier. Un ordre stable pour diffs et relectures, tableaux et nombres intacts.
Mis à jour le 8 novembre 202610 min de lecture
Pour trier les clés JSON par ordre alphabétique en ligne, ouvrez le trieur de clés JSON, déposez un fichier .json ou collez le texte, laissez l'ordre sur Alphabétique et cliquez sur Trier les clés. Chaque objet du document, aussi profondément imbriqué soit-il, revient avec ses clés de A à Z. Les tableaux gardent leur ordre sauf si vous demandez autre chose, et les valeurs sont recopiées caractère par caractère : seuls l'ordre des clés et l'indentation changent. La suite de ce guide explique pourquoi c'est utile, quand ne trier que le premier niveau et les quelques cas qui surprennent.
Pourquoi trier les clés JSON par ordre alphabétique
Un objet JSON est, par définition, un ensemble non ordonné de noms et de valeurs. La norme laisse l'ordre des clés à celui qui écrit le fichier, si bien que deux programmes qui exportent les mêmes données peuvent produire les clés dans des ordres différents : l'ordre dans lequel la base de données a renvoyé les colonnes, l'ordre dans lequel un développeur a ajouté des champs au fil des années, ou l'ordre qu'une bibliothèque utilise en interne. Les données sont identiques. Le texte, non.
Cette différence compte dès qu'une personne ou un outil qui travaille ligne par ligne lit le fichier. Trier les clés donne à chaque export une forme prévisible, ce qui aide dans trois situations courantes :
- Les diffs dans le contrôle de version. Quand un fichier de configuration est régénéré avec ses clés mélangées, un diff ligne par ligne marque la moitié du fichier comme modifiée. Avec des clés triées, le diff ne montre que les lignes dont la valeur a vraiment changé.
- Les relectures de code. Celui qui cherche
timeoutdans un fichier de réglages de 300 lignes le trouve toujours au même endroit, et une clé en double ou mal orthographiée se retrouve juste à côté de sa jumelle correcte, là où elle saute aux yeux. - Une sortie stable. Les caches, les sommes de contrôle et les tests d'instantanés qui comparent des fichiers octet par octet échouent alors que seul l'ordre a changé. Un fichier trié et indenté de façon uniforme produit les mêmes octets pour les mêmes données.
Si vous voulez seulement voir ce qui a changé entre deux versions, inutile de trier d'abord : une comparaison structurelle ignore déjà l'ordre des clés, comme l'explique comment comparer deux fichiers JSON. Le tri sert quand le fichier lui-même doit être versionné, relu ou livré sous une forme stable.
Trier des clés JSON, étape par étape
Ajoutez votre JSON
Déposez un fichier .json, .jsonc, .ndjson ou .jsonl sur le trieur de clés JSON, parcourez vos dossiers pour le choisir, ou collez le texte dans la zone située sous l'espace de dépôt.
Choisissez l'ordre
Alphabétique est l'ordre par défaut, celui qu'attendent la plupart des outils de diff et des guides de style. Choisissez Naturel si vos clés sont numérotées, Longueur de clé pour placer les clés courtes en premier, ou Par valeur pour ranger les membres selon ce qu'ils contiennent. Réglez le Sens sur A → Z ou Z → A.
Décidez de la profondeur
Laissez Profondeur sur Tous les niveaux pour trier chaque objet imbriqué, ou choisissez Premier niveau seulement, 2 niveaux ou 3 niveaux pour garder l'ordre intérieur tel qu'il est écrit.
Ouvrez Avancé si besoin
Épinglez des clés en haut, choisissez le sort des clés en double, triez des tableaux, ou activez Accepter les commentaires et virgules finales pour les fichiers JSONC.
Triez et enregistrez
Cliquez sur Trier les clés, choisissez 2 espaces, 4 espaces, tabulation ou une sortie minifiée, puis téléchargez le fichier ou copiez-le. Si vous modifiez un réglage ensuite, le résultat est signalé comme produit avec d'anciens réglages pour que vous puissiez le réappliquer.
Quatre préréglages remplissent ces options en un clic : Alphabétique, package.json, Adapté aux diffs et Minifié. Adapté aux diffs utilise l'ordre naturel, ignore la casse, trie les tableaux de valeurs simples et termine le fichier par un saut de ligne, un choix judicieux pour un fichier qui vit dans un dépôt.
Ordre alphabétique, naturel ou par longueur de clé, à tous les niveaux ou au premier seulement, avec des valeurs laissées telles quelles. Gratuit : un document jusqu'à 25 MB, avec toutes les options de tri. Pro : pas de limite de taille au-delà de ce que votre appareil supporte, et jusqu'à 20 documents à la fois dans une seule archive. Tout s'exécute sur votre appareil, pas sur nos serveurs.
Trier les clés JSONTri récursif ou premier niveau seulement ?
Le tri est récursif par défaut : l'objet extérieur est trié, puis chaque objet qu'il contient, puis ceux qu'ils contiennent, jusqu'au bout. C'est ce qu'il faut pour les réponses d'API, les données exportées et la plupart des fichiers générés, puisque le but est une forme prévisible partout.
Certains fichiers ont un ordre qui a du sens à l'intérieur de leurs sections. Un fichier de réglages écrit à la main peut placer host avant port, puis user, parce que c'est ainsi qu'on le lit, alors que les sections peuvent venir dans n'importe quel ordre. Réglez Profondeur sur Premier niveau seulement : les sections sont triées et leur contenu reste tel qu'il est écrit. Les options 2 niveaux et 3 niveaux se situent entre les deux.
| Réglage de profondeur | Ce qui bouge | Idéal pour |
|---|---|---|
| Tous les niveaux | Les clés de tous les objets, à n'importe quelle profondeur | Réponses d'API, exports, configuration générée |
| Premier niveau seulement | Seulement les clés extérieures (et celles de chaque enregistrement d'une liste au premier niveau) | Sections ordonnées à la main, manifestes de paquets |
| 2 niveaux / 3 niveaux | Les clés jusqu'à cette profondeur ; les objets plus profonds restent intacts | Grosses configurations dont le détail intérieur est ordonné exprès |
Ce que deviennent les tableaux
Les tableaux gardent leur ordre d'origine. Contrairement aux clés d'un objet, les positions dans un tableau ont souvent un sens : les étapes d'une séquence, le classement de résultats de recherche, les calques d'une image. Les réordonner changerait les données, pas seulement leur présentation. Les clés des objets situés dans un tableau sont toujours triées selon les règles normales ; seule la position des éléments est protégée.
Deux réglages facultatifs dans Avancé changent cela quand vous le voulez. Trier aussi les tableaux de valeurs simples réordonne les tableaux qui ne contiennent que des chaînes, des nombres, des booléens ou null, comme une liste d'étiquettes. Les valeurs sont d'abord groupées par type, puis triées dans chaque groupe. Trier les listes d'objets par prend un nom de propriété comme id et range une liste d'enregistrements selon celle-ci ; les enregistrements où elle manque gardent leur ordre relatif, à la fin. Chacun des deux laisse intact un tableau qui ne correspond pas entièrement à la règle : vous n'obtenez jamais une liste à moitié triée.
Ce que deviennent les nombres et les autres valeurs
Beaucoup d'outils trient les clés en lisant le JSON en mémoire puis en le réécrivant. Cet aller-retour modifie en silence des valeurs qui étaient correctes. Ce trieur travaille directement sur le texte, si bien que les valeurs ressortent exactement comme elles sont entrées :
| Dans votre fichier | Après lecture et réécriture | Avec ce trieur |
|---|---|---|
| 12345678901234567890 | 12345678901234567000 | 12345678901234567890 |
| 1.0 | 1 | 1.0 |
| 1e5 | 100000 | 1e5 |
| "caf\u00e9" | "café" | "caf\u00e9" |
| La même clé deux fois | Seule la dernière est gardée | Les deux sont gardées et comptées |
C'est la première ligne qui cause de vrais dégâts. Les nombres JSON ordinaires sont stockés en virgule flottante double précision, qui ne représente les entiers exactement que jusqu'à 9 007 199 254 740 991. Les longs identifiants de base de données, les numéros de commande et les horodatages en nanosecondes dépassent souvent cette valeur, et une lecture suivie d'une réécriture remplace leurs derniers chiffres sans prévenir. Comme le texte n'est pas touché ici, un fichier trié ne diffère de l'original que par l'ordre des clés et les espaces.
Les clés qui ressemblent à des nombres sont un autre piège. Quand un programme JavaScript reconstruit un objet, des clés comme "10" ou "2" passent en tête dans l'ordre numérique, quel que soit l'ordre demandé. Ici, elles sont triées comme n'importe quelle autre clé : comme du texte en ordre Alphabétique, ou comme des nombres en ordre Naturel.
Alphabétique, naturel ou sans tenir compte de la casse : quel ordre choisir
L'ordre Alphabétique compare les clés caractère par caractère selon leur point de code Unicode. Cela a deux effets visibles. Les majuscules passent avant les minuscules, donc Zone se place au-dessus de apple ; et les lettres accentuées viennent après l'alphabet de base, donc élan arrive après zebra. Activez Ignorer la casse si Name et name doivent rester ensemble plutôt que dans deux blocs séparés.
L'ordre Naturel lit les chiffres contenus dans une clé comme des nombres, donc item2 passe avant item10. En ordre alphabétique simple, item10 passe en premier, parce que le caractère 1 est inférieur à 2. Utilisez l'ordre naturel pour des clés numérotées comme step1 à step12 ; gardez l'alphabétique quand le fichier doit correspondre à ce qu'attend un autre outil ou un schéma, puisque la plupart trient ainsi.
L'épinglage s'ajoute à l'un ou l'autre ordre. Saisissez des clés dans Épingler ces clés en haut, séparées par des virgules : elles apparaissent en haut dans cet ordre, à tous les niveaux, et le reste est trié en dessous. Un astérisque final correspond à un préfixe, donc x-* garde ensemble tous les champs d'extension. Le préréglage package.json remplit la liste avec les champs par lesquels ce fichier commence habituellement, comme name, version et description.
Quand le tri se passe mal
- Le fichier ne s'ouvre pas. Un JSON invalide est signalé avec la ligne, la colonne et un caret ^ sous le problème. Une virgule manquante ou une clé sans guillemets en est la cause habituelle ; le validateur JSON et le formateur JSON aident à le corriger.
- Il contient des commentaires. Des fichiers comme tsconfig.json ou les réglages d'un éditeur contiennent des commentaires et des virgules finales, que le JSON strict interdit. Activez Accepter les commentaires et virgules finales ; chaque commentaire reste attaché à la clé située en dessous et se déplace avec elle. Une sortie minifiée ne peut pas porter de commentaires, ils y sont donc omis.
- Un document par ligne. Les fichiers NDJSON et JSON Lines sont détectés automatiquement et chaque ligne est triée séparément. Le réglage d'indentation ne s'applique pas, car chaque enregistrement doit rester sur une seule ligne.
- Le fichier est trop gros. La version gratuite accepte un document jusqu'à 25 MB. Si le fichier est plus lourd, le minifier d'abord le fait souvent passer sous la limite, car l'indentation peut représenter une bonne partie d'un fichier mis en forme.
- Des clés dont vous ne voulez pas du tout. Le tri ne fait que déplacer les clés. Pour retirer des champs comme des identifiants internes avant de partager un fichier, utilisez d'abord Supprimer des clés JSON, puis triez.
Questions fréquentes
Comment trier les clés JSON par ordre alphabétique en ligne ?
Collez votre JSON ou déposez le fichier dans le trieur de clés JSON, laissez l'ordre sur Alphabétique et cliquez sur Trier les clés. Chaque objet de chaque niveau est trié de A à Z, les tableaux gardent leur ordre, et vous pouvez télécharger ou copier le résultat. La version gratuite couvre un document jusqu'à 25 MB.
Le tri des clés JSON trie-t-il aussi les objets imbriqués ?
Oui, par défaut. Profondeur est réglé sur Tous les niveaux, donc les objets dans des objets et les objets dans des tableaux sont tous triés. Choisissez Premier niveau seulement, 2 niveaux ou 3 niveaux pour laisser les objets plus profonds tels qu'ils sont écrits.
Le tri change-t-il l'ordre de mes tableaux ?
Non, sauf si vous l'activez. L'ordre d'un tableau a généralement un sens, donc seules les clés des objets bougent. Dans Avancé, vous pouvez trier les tableaux de valeurs simples, ou trier une liste d'objets selon une propriété comme id.
Trier les clés JSON peut-il modifier mes nombres ?
Pas avec cet outil. Les valeurs sont recopiées depuis votre fichier caractère par caractère, donc 1.0, 1e5 et les entiers de plus de 16 chiffres restent exactement tels quels. Les outils qui lisent puis réécrivent le JSON peuvent arrondir les grands entiers et reformater les nombres.
Pourquoi item10 passe-t-il avant item2 lors du tri ?
L'ordre alphabétique compare des caractères, et 1 vient avant 2, donc item10 arrive en premier. Passez à l'ordre Naturel, qui lit les chiffres comme des nombres et place item2 avant item10.
Puis-je garder certaines clés en haut, comme id ou name ?
Oui. Ouvrez Avancé et listez-les dans Épingler ces clés en haut, séparées par des virgules. Elles apparaissent dans cet ordre au-dessus des clés triées, à tous les niveaux. Un astérisque final, comme dans x-*, épingle toutes les clés qui ont ce préfixe.