jq Playground
Tippe einen jq-Filter ein und sieh das Ergebnis sofort. Füge dein JSON (oder JSON Lines) ein, schalte jq-Flags wie -r, -c und -s um und lerne aus einer Bibliothek fertiger Filter. Alles läuft lokal in deinem Browser.
Zuletzt aktualisiert:
Läuft live während der Eingabe. Strg+Eingabe führt sofort aus. Mehrzeilige Filter, def-Funktionen und Kommentare (#) sind erlaubt.
Bibliothek mit Beispielfiltern
Anleitung: jq Playground
- Füge dein JSON in das Eingabefeld ein, zieh eine .json-Datei darauf oder behalte die Beispieldaten.
- Tippe einen jq-Filter wie
.users[] | select(.active) | .nameein. Die Ausgabe aktualisiert sich während der Eingabe. - Schalte Flags um, etwa
-rfür Roh-Strings,-cfür ein Ergebnis pro Zeile oder-s, um JSON Lines in ein Array einzulesen. - Stöbere in der Beispielbibliothek und klicke auf eine Karte, um einen funktionierenden Filter zu laden, den du anpassen kannst.
- Kopiere oder lade die Ausgabe herunter oder kopiere den passenden
jq-Befehl für dein Terminal.
jq-Spickzettel
| Filter | Was er macht | Beispielergebnis |
|---|---|---|
. | Identität: die gesamte Eingabe | Schön formatiertes JSON |
.key, .a.b, ."my-key" | Objektfeld (null, falls nicht vorhanden) | .name → "Ada" |
.[0], .[-1], .[2:4] | Array-Index, vom Ende, Ausschnitt | [1,2,3] | .[-1] → 3 |
.[], .[]? | Jedes Element / jeder Wert (? ignoriert Fehler) | Ein Ergebnis pro Element |
a | b | Pipe: gibt jede Ausgabe von a an b weiter | .users[] | .name |
a, b | Beide Ausgaben | .name, .age |
[ ... ], {a, b: .c} | Ein Array oder Objekt bauen | {name, city: .address.city} |
select(cond) | Behält die Eingabe nur, wenn cond wahr ist | select(.age > 30) |
map(f), map_values(f) | Wendet f auf jedes Element an | map(.price * 2) |
a // b | Alternative: b, wenn a null, false oder leer ist | .email // "none" |
.a = v, .a |= f, .a += 1 | Einen Pfad setzen, aktualisieren oder ändern | .n |= . + 1 |
del(.a), to_entries und with_entries(f) | Pfade löschen, mit Schlüssel-Wert-Paaren arbeiten | with_entries(.key |= ascii_upcase) |
sort_by(f), group_by(f) und unique_by(f) | Nach einem Schlüssel sortieren, gruppieren oder Duplikate entfernen | sort_by(-.age) |
add, length, min_by(f) und max_by(f) | Ein Array aggregieren | [.[].n] | add |
reduce .[] as $x (startwert; aktualisierung) | Viele Werte zu einem zusammenfassen | reduce .[] as $x (0; . + $x) |
"\(.a) and \(.b)" | String-Interpolation | "Hi \(.name)" |
test(), capture(), sub() und gsub() | Reguläre Ausdrücke | gsub("\\s+"; " ") |
@csv, @tsv, @base64, @uri, @html und @sh | Format-Strings (mit -r verwenden) | [.id, .name] | @csv |
.., paths und getpath(p) | Jeden Wert / Pfad durchlaufen | [.. | numbers] |
try f catch g oder f? | Fehler behandeln | try tonumber catch 0 |
jq-Befehlszeilen-Flags
| Flag | Bedeutung | Typische Verwendung |
|---|---|---|
-r | Rohausgabe: Strings ohne Anführungszeichen | Namenslisten, CSV-/TSV-Zeilen, Shell-Skripte |
-c | Kompakte Ausgabe: ein Ergebnis pro Zeile | JSON Lines erzeugen, Logs |
-s | Slurp: alle Eingaben in ein Array einlesen | JSON Lines zählen oder summieren |
-n | Null-Eingabe: mit null beginnen | JSON erzeugen, mit input/inputs lesen |
-R | Roheingabe: jede Zeile ist ein String | CSV oder reinen Text mit jq verarbeiten |
-S | Objektschlüssel in der Ausgabe sortieren | Stabile Diffs |
-j | Join: Rohausgabe ohne Zeilenumbrüche | Einen langen String bauen |
--arg name wert / --argjson name json | Definiert $name | Shell-Werte sicher an einen Filter übergeben |
Tipps zum Schreiben von jq-Filtern
Baue Filter Schritt für Schritt. Beginne mit ., füge jeweils eine Pipe hinzu und beobachte, wie sich die Ausgabe ändert. Liefert ein Schritt viele Ergebnisse, pack ihn in [ ], um sie als ein Array zu sehen.
Fehlende Felder sind null, keine Fehler. .missing gibt null zurück, aber .missing[] oder .missing.x auf einer Zahl schlägt fehl. Nutze ?, // default oder select(), um optionale Daten abzusichern.
Setze Filter in der Shell in Anführungszeichen. Unter Linux und macOS packst du den Filter in einfache Anführungszeichen: jq -r '.items[] | .name' data.json. Der Befehl unter der Ausgabe ist bereits für dich passend gequotet.
Häufige Fragen
Was ist jq?
jq ist ein JSON-Prozessor für die Befehlszeile. Ein jq-Filter beschreibt, wie JSON umgewandelt wird: Felder mit .name auswählen, Arrays mit .[] durchlaufen, mit select() filtern, mit {} und [] umformen und mit Funktionen wie map, group_by, add und reduce aggregieren. In diesem Playground kannst du Filter ausprobieren, ohne etwas zu installieren.
Wird mein JSON auf einen Server hochgeladen?
Nein. Die jq-Engine läuft komplett in JavaScript in deinem Browser (in einem Hintergrund-Worker), sodass deine Daten nie dein Gerät verlassen und die Seite nach dem Laden auch offline funktioniert.
Ist das dasselbe wie das echte jq?
Die Engine folgt der Syntax und Semantik von jq 1.7, einschließlich Pfaden, Zuweisungsoperatoren, reduce, foreach, label/break, try/catch, Destrukturierung, @formats und den meisten eingebauten Funktionen. Kleine Unterschiede: Reguläre Ausdrücke nutzen die Engine des Browsers statt Oniguruma, Datumsangaben werden in UTC verarbeitet, Module (import/include) sind nicht verfügbar, $ENV ist leer und Zahlen sind 64-Bit-Gleitkommazahlen.
Wie bekomme ich eine Ausgabe ohne Anführungszeichen?
Aktiviere -r (Rohausgabe). Strings werden dann als reiner Text ausgegeben, was du für Namenslisten, @csv- oder @tsv-Zeilen und Shell-Skripte brauchst. Zahlen, Arrays und Objekte werden weiterhin als JSON ausgegeben.
Wie verarbeite ich JSON Lines (NDJSON) oder mehrere JSON-Dokumente?
Füge sie einfach nacheinander ein. jq führt den Filter einmal pro Wert aus. Aktiviere -s (slurp), um zuerst alle Werte in ein einziges Array einzulesen, zum Beispiel um sie mit length oder add zu zählen oder zu summieren.
Warum bekomme ich Fehler wie "Cannot iterate over null" oder "Cannot index"?
Der Filter hat versucht, .[] oder .key auf einen Wert des falschen Typs anzuwenden, oft weil ein Feld bei manchen Elementen fehlt (null). Hänge ? an, um Fehler zu ignorieren (.items[]?), nutze //, um einen Standardwert zu setzen (.items // []), oder filtere zuerst mit select(.items != null).
Wie übergebe ich einen Wert an einen Filter wie mit --arg?
Öffne Variablen und füge eine Zeile wie country=US (ein String, wie --arg) oder limit:=10 (JSON, wie --argjson) hinzu. Verwende sie im Filter als $country oder $limit. Die Befehlszeile unter der Ausgabe enthält die passenden --arg-Optionen.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.