Outils JSON
Exécutez jq sur du JSON ou du texte. Choisissez le mode de lecture, examinez stdout et reprenez le programme dans votre shell.
Aperçu par blocs de 5 000 caractères. Copie et téléchargement incluent le résultat complet.
Entrée et programme restent en mémoire dans le navigateur, sans historique enregistré.
Options autorisées : -c -r -j -S -a -e, combinaisons courtes et alias longs. Choisissez -s/-R/-n dans le mode d’entrée.
jq 1.8.2 · WebAssembly local · exécution manuelle
Résultat périmé : copie et téléchargement désactivés.
Shell POSIX uniquement. Enregistrez d’abord l’entrée dans input.json ; la commande copiée ne contient pas vos données.
Le jq playground aide à ne garder que les champs utiles d’une réponse API. Essayez une condition avec select, remodelez les objets avec map et conservez l’entrée originale pour comparer.
Pour filtrer JSON ou transformer JSON, la forme du résultat compte autant que son contenu. Avant de reprendre jq en ligne de commande, vérifiez si le programme produit plusieurs valeurs, un tableau ou aucune sortie.
Le filtre .people[] | select(.age >= 18) | .name produit une chaîne par personne majeure. La sortie conserve ces valeurs séparées et leurs retours à la ligne : vous voyez ce que recevra le programme suivant.
Le jq playground applique -s avant votre programme afin de réunir toutes les entrées JSON dans un tableau. Entourer un filtre de crochets rassemble plutôt ses résultats pour chaque entrée courante.
Le mode JSON lit des valeurs successives. Slurp les rassemble ; le mode brut lit le texte ligne par ligne, tandis que brut avec slurp lit une chaîne entière. Le mode null commence avec null, mais input et inputs peuvent encore lire les données fournies.
Importer un fichier, charger un exemple ou effacer ouvre d’abord un aperçu. Appliquer remplace les contenus et réglages indiqués ; une annulation restaure aussi le résultat précédent. Lancez avec le bouton ou Ctrl/Cmd+Entrée. Une modification bloque l’export jusqu’au prochain calcul.
Tous les codes de retour sont affichés. Un code non nul bloque l’export, même lorsque -e signale seulement false, null ou une absence de résultat. Retirez -e si nécessaire et relancez. La commande POSIX attend les mêmes données dans input.json.
select conserve les enregistrements qui correspondent ; map produit un tableau d’éléments transformés. L’exemple compare des âges numériques et construit des objets avec un booléen adult. Une chaîne contenant des chiffres reste un autre type JSON.
Le moteur WASM jq 1.8.2 prend en charge les pipes, reduce, def, la récursion, try/catch et les expressions régulières. Il exécute jq lui-même. Les modules sur fichier et les arguments CLI de fichiers supplémentaires ne sont pas exposés.
-r retire les guillemets JSON des chaînes, -j supprime les séparateurs de sortie, -c compacte le JSON, -S trie les clés et -a utilise les échappements ASCII. Les options courtes combinées et leurs alias longs sont acceptés ; les autres options sont refusées.
Les espaces, un éventuel BOM initial et les caractères NUL restent dans le texte exporté. Les messages debug et stderr apparaissent séparément. L’aperçu s’étend par blocs de 5 000 caractères ; un export autorisé contient tout le résultat.
Pour l’exemple, utilisez .people[] | select(.age >= 18) | .name. [] émet chaque fiche, select conserve les correspondances et .name extrait le champ. Entourez le filtre entier de crochets si l’étape suivante attend un tableau.
Ajoutez -r dans les options de sortie. Les chaînes perdent leurs guillemets JSON, mais gardent leurs espaces internes. Les objets et tableaux restent sérialisés en JSON. Utilisez -j uniquement si vous voulez également supprimer les séparateurs entre résultats.
Écrivez [.people[] | select(.age >= 18)]. Les crochets rassemblent les valeurs émises par le filtre. Sans correspondance, vous obtenez [] plutôt qu’un flux vide, ce qui peut changer le comportement de la commande suivante.
Choisissez le mode de collecte JSON (-s), puis lancez . pour voir le tableau. Si les entrées sont elles-mêmes des tableaux, -s avec add permet de les concaténer. Fusionner des objets est différent : il faut décider quoi faire des clés dupliquées.
Choisissez le mode lignes de texte (-R) et commencez par split("=") | {(.[0]): .[1]} pour des lignes simples. Retirez au besoin les espaces autour des clés et valeurs. Si une valeur contient un autre signe égal, adaptez le découpage : les formats de configuration n’ont pas tous les mêmes règles d’échappement.
Une requête est-elle mal traitée ?
Utilisez le jq playground pour comparer plusieurs résultats séparés avec map, puis reprenez le programme vérifié dans votre script.