jq Playground — tester des expressions jq en ligne.

C'est le vrai jq. La page charge jq 1.8.2 compilé en WebAssembly — le programme C réel, 907 KB non compressé et de 250 à 340 KB sur le réseau, selon que votre navigateur négocie brotli ou gzip — et y fait passer votre filtre. Le badge de version affiché à côté des flags est lu dans ce binaire au moment de l'exécution, il n'est pas écrit dans la page : il ne peut donc pas devenir obsolète. Rien ici n'approxime le comportement de jq, parce que rien ici ne le réimplémente : le même code que sur votre portable tourne dans votre onglet.

Non. Il n'y a ni serveur, ni API, ni journalisation. jq est téléchargé une seule fois depuis ce site comme fichier statique, puis s'exécute entièrement dans votre onglet — c'est exactement la différence avec un playground côté serveur : avec jqplay.org et ses semblables, le JSON que vous collez part vers la machine de quelqu'un d'autre pour y être évalué. Vous pouvez coller ici sans crainte des sorties kubectl de production, des réponses d'API contenant des jetons et des lignes de log contenant des données clients.

Quatre interrupteurs : -r (sortie de chaînes brute), -s (rassembler tout le flux d'entrée dans un tableau), -n (exécuter une fois avec null en entrée) et -c (compact, une ligne par résultat). Absents de cette version : --arg et --argjson, le chargement de modules (-L, include, import — jq répond « module not found »), --seq, la sortie en couleur, les arguments de fichier et la lecture depuis une URL. --arg peut être remplacé dans le programme lui-même : ("prod") as $ns | … lie une valeur de la même façon.

Le plus souvent parce qu'il utilise un builtin qui n'existe pas dans jq 1.8.2. leaf_paths est le cas classique — il a été supprimé, et jq répond « leaf_paths/0 is not defined » ; l'écriture qui fonctionne est paths(scalars). Il en va de même pour les flags inventés et pour les builtins d'autres outils (jaq, gojq, JMESPath) qui n'ont jamais existé dans jq. Une erreur de compilation cite ici le message propre de jq, avec sa ligne, sa colonne et son extrait au caret : vous voyez exactement quel token a été refusé au lieu de le deviner.

-s lit toutes les valeurs du flux d'entrée dans un seul tableau et exécute votre filtre une fois sur ce tableau : 1 2 3 devient [1,2,3]. -n exécute le filtre une fois avec null en entrée et vous remet le flux via le générateur inputs, donc [inputs] sur 1 2 3 donne aussi [1,2,3] — mais c'est vous qui décidez quand chaque valeur est tirée, et c'est ce qui permet d'apparier des valeurs, de sauter un enregistrement d'en-tête ou de s'arrêter tôt. -s met tout en mémoire d'abord ; -n avec inputs travaille en flux.

Parce que -r ne retire que les guillemets autour des résultats qui sont des chaînes. Tout ce qui n'est pas une chaîne — un objet, un tableau, un nombre, un booléen ou null — reste affiché en JSON, et c'est pourquoi . sur {"a":1} est identique avec et sans -r. Si vous voulez du texte à partir d'autre chose qu'une chaîne, convertissez-le dans le filtre : tostring, @csv, @tsv, join(",") ou une chaîne interpolée comme "\(.name) → \(.image)".

Construisez un tableau par ligne et passez-le dans @csv ou @tsv, puis activez -r pour que la ligne soit écrite en texte et non en chaîne JSON entre guillemets. ["web",3] | @csv donne "web",3 — chaînes entre guillemets, nombres nus — et @tsv donne web, puis une vraie tabulation, puis 3. Les deux refusent les valeurs imbriquées : un tableau ou un objet dans une ligne est une erreur d'exécution (« array ([\"a\"]) is not valid in a csv row »), et null devient un champ vide.

a // b produit a, sauf si a vaut false, null, ou ne produit aucune sortie — dans ce cas il produit b. Le piège : cela ne veut pas dire « si vide ». En jq, 0 et la chaîne vide sont vrais, donc {"a":0} | .a // "fallback" donne 0 et non "fallback". Si vous voulez vraiment dire « quand la clé est absente », demandez-le : if has("a") then .a else "fallback" end.

Pas tant que la valeur reste intacte. jq 1.8 conserve le littéral que vous avez fourni : {"n":9007199254740993} | .n affiche exactement 9007199254740993 — un nombre que JavaScript ne peut pas représenter — et 1.0 reste 1.0 au lieu de se réduire à 1. Dès que vous faites un calcul dessus, la garantie s'arrête : .n + 0 devient 9007199254740992, parce que le calcul passe par un double 64 bits. C'est une propriété de jq, pas du navigateur ; jq en ligne de commande répond la même chose.

L'entrée est plafonnée à 2 MB (2 000 000 d'octets) et le panneau de résultats affiche les 200 premières sorties, toujours avec le nombre réel à côté — « Copy all » copie quand même tout. Un filtre qui ne se termine jamais est la seule chose qui fasse vraiment mal : jq s'exécute de façon synchrone dans cet onglet, il bloque donc la page jusqu'au rechargement. Obtenir une carte d'erreur à la place dépend de la forme. Si le flux infini est collecté — [repeat(1)], [recurse(.a)], length, last —, jq remplit sa mémoire WebAssembly et s'interrompt au bout d'une à deux secondes, et le playground en fait un message d'erreur ordinaire. S'il ne fait que couler, un repeat(1) ou un recurse(.a) nus continuent : nous avons mesuré 40 secondes sans aucune interruption. Les deux formes à surveiller sont un repeat sans garde-fou et recurse(.field), qui arrive sur null puis récurse sur null indéfiniment — écrivez recurse(.field?; . != null), ou enveloppez le générateur dans limit(n; …).