Startseite › Entwickler-Tools › jq Playground

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.

Eingabe JSON
0 B
Ausgabe bereit


Befehlszeile

Bibliothek mit Beispielfiltern

Anzeige
Anzeige

Anleitung: jq Playground

  1. Füge dein JSON in das Eingabefeld ein, zieh eine .json-Datei darauf oder behalte die Beispieldaten.
  2. Tippe einen jq-Filter wie .users[] | select(.active) | .name ein. Die Ausgabe aktualisiert sich während der Eingabe.
  3. Schalte Flags um, etwa -r für Roh-Strings, -c für ein Ergebnis pro Zeile oder -s, um JSON Lines in ein Array einzulesen.
  4. Stöbere in der Beispielbibliothek und klicke auf eine Karte, um einen funktionierenden Filter zu laden, den du anpassen kannst.
  5. Kopiere oder lade die Ausgabe herunter oder kopiere den passenden jq-Befehl für dein Terminal.

jq-Spickzettel

FilterWas er machtBeispielergebnis
.Identität: die gesamte EingabeSchö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 | bPipe: gibt jede Ausgabe von a an b weiter.users[] | .name
a, bBeide 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 istselect(.age > 30)
map(f), map_values(f)Wendet f auf jedes Element anmap(.price * 2)
a // bAlternative: b, wenn a null, false oder leer ist.email // "none"
.a = v, .a |= f, .a += 1Einen Pfad setzen, aktualisieren oder ändern.n |= . + 1
del(.a), to_entries und with_entries(f)Pfade löschen, mit Schlüssel-Wert-Paaren arbeitenwith_entries(.key |= ascii_upcase)
sort_by(f), group_by(f) und unique_by(f)Nach einem Schlüssel sortieren, gruppieren oder Duplikate entfernensort_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 zusammenfassenreduce .[] as $x (0; . + $x)
"\(.a) and \(.b)"String-Interpolation"Hi \(.name)"
test(), capture(), sub() und gsub()Reguläre Ausdrückegsub("\\s+"; " ")
@csv, @tsv, @base64, @uri, @html und @shFormat-Strings (mit -r verwenden)[.id, .name] | @csv
.., paths und getpath(p)Jeden Wert / Pfad durchlaufen[.. | numbers]
try f catch g oder f?Fehler behandelntry tonumber catch 0

jq-Befehlszeilen-Flags

FlagBedeutungTypische Verwendung
-rRohausgabe: Strings ohne AnführungszeichenNamenslisten, CSV-/TSV-Zeilen, Shell-Skripte
-cKompakte Ausgabe: ein Ergebnis pro ZeileJSON Lines erzeugen, Logs
-sSlurp: alle Eingaben in ein Array einlesenJSON Lines zählen oder summieren
-nNull-Eingabe: mit null beginnenJSON erzeugen, mit input/inputs lesen
-RRoheingabe: jede Zeile ist ein StringCSV oder reinen Text mit jq verarbeiten
-SObjektschlüssel in der Ausgabe sortierenStabile Diffs
-jJoin: Rohausgabe ohne ZeilenumbrücheEinen langen String bauen
--arg name wert / --argjson name jsonDefiniert $nameShell-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.

Ähnliche Tools

Alle Code-Playgrounds & Tester ansehen →