jq-Playground
| Filter | Beschreibung |
|---|---|
| Gesamtes Dokument formatiert ausgeben | |
| Über jedes Element eines Arrays iterieren | |
| Einen verschachtelten Wert über den Pfad lesen | |
| Nur Elemente behalten, die eine Bedingung erfüllen | |
| Jedes Element eines Arrays umwandeln | |
| Die Schlüssel eines Objekts auflisten | |
| Ein Objekt in Schlüssel-Wert-Paare umwandeln | |
| Elemente nach einem Feld gruppieren und zählen | |
| Ein Array nach einem Feld sortieren | |
| Array-Elemente zählen | |
| Zeilen als CSV formatieren (Rohausgabe aktivieren) | |
| Einen String Base64-kodieren (Rohausgabe aktivieren) | |
| Die Pfade aller numerischen Werte auflisten | |
| Alle Zahlen rekursiv einsammeln | |
| Werte mit reduce aufsummieren | |
| Alle Eingaben mit Null-Eingabe lesen (mehrere JSON-Dokumente ausprobieren) |
Technische Details
So funktioniert der jq-Playground
Was das Tool macht
Der jq-Playground führt echte jq-Filter beim Tippen auf Ihrem JSON aus. jq 1.8 wird zu WebAssembly kompiliert und in einem Web Worker ausgeführt, sodass die Ergebnisse exakt mit dem Kommandozeilen-Tool übereinstimmen, einschließlich der Fehlermeldungen. Fügen Sie JSON ein, schreiben Sie einen Filter wie .users[] | select(.age > 30) | .name, und die Ausgabe wird nach einer kurzen Pause aktualisiert. Die Optionen entsprechen direkt den jq-Flags: Rohausgabe (-r), kompakt (-c), Slurp (-s), Null-Eingabe (-n), sortierte Schlüssel (-S), Tab-Einrückung (--tab) und benannte --arg-Variablen.
Typische Anwendungsfälle
Entwickler nutzen es, um Filter zu prototypen, bevor sie sie in Shell-Skripte, CI-Pipelines und Kubernetes- oder AWS-CLI-Einzeiler übernehmen, um große API-Antworten und Logzeilen zu erkunden, um JSON mit @csv in CSV umzuwandeln, um Payloads mit map, group_by und reduce umzuformen und um jq anhand des eingebauten Spickzettels mit anklickbaren Beispielen zu lernen.
Eingaben, Ausgaben und Flags
Die Eingabe kann ein einzelnes JSON-Dokument oder mehrere aneinandergehängte Dokumente wie NDJSON sein; mit Slurp werden sie in ein Array verpackt, und mit Null-Eingabe lesen Sie sie selbst über input und inputs. Jedes Ergebnis wird in einer eigenen Zeile ausgegeben. Die Rohausgabe gibt Strings ohne Anführungszeichen aus, was für die Ausgabe von @csv, @tsv, @base64 und @uri nötig ist. Mit --arg übergebene Werte stehen im Filter als $name zur Verfügung und sind immer Strings.
Fallstricke und Grenzen
Die Eingabe ist auf 5 MB begrenzt, und ein Lauf wird nach 10 Sekunden gestoppt, damit ein Endlosfilter die Seite nicht einfrieren kann. Zahlen werden mit der Double-Precision-Semantik von jq verarbeitet, daher können Ganzzahlen jenseits von 2^53 an Genauigkeit verlieren. Shell-Quoting ist hier nicht nötig: Im Terminal setzen Sie den Filter in einfache Anführungszeichen. Dieser Playground unterstützt keine jq-Module, keine Importe aus Dateien und keine Umgebungsvariablen.