Startseite › Entwickler-Tools › JSONPath Tester

JSONPath Tester

Gib einen JSONPath-Ausdruck ein und sieh das Ergebnis sofort. Jeder Treffer wird in deinem JSON hervorgehoben und mit seinem exakten normalisierten Pfad aufgelistet, sodass du Filter, Slices und rekursive Abfragen in Sekunden debuggen kannst.

Zuletzt aktualisiert:

0 Treffer
Anzeige
Anzeige

Anleitung: JSONPath Tester

  1. Füge dein JSON in den linken Editor ein, lade eine Datei hoch oder behalte das Buchladen-Beispiel.
  2. Gib einen JSONPath-Ausdruck, der mit $ beginnt, in das Abfragefeld ein oder klicke auf eines der Beispiele.
  3. Beobachte die Treffer, die im Tab Hervorgehoben aufleuchten. Der Zähler zeigt, wie viele Knoten gefunden wurden.
  4. Wechsle die Tabs, um das Ergebnis als JSON-Array oder als Liste normalisierter Pfade zu sehen.
  5. Kopiere das Ergebnis oder die Pfade mit einem Klick und verwende den Ausdruck in deinem Code.

JSONPath-Syntax Spickzettel

SyntaxBedeutungBeispiel
$Die Wurzel des Dokuments$
.name / ['name']Kind-Eigenschaft (verwende Klammern für Namen mit Leerzeichen oder Symbolen)$.store['bicycle']
..nameRekursiver Abstieg: die Eigenschaft in beliebiger Tiefe$..price
*Wildcard: jede Eigenschaft bzw. jedes Array-Element$.store.*, $..book[*]
[n]Array-Index, beginnend bei null; negative Werte zählen vom Ende$..book[0], $..book[-1]
[a,b]Vereinigung mehrerer Indizes oder Namen$..book[0,2], $['a','b']
[start:end:step]Array-Slice; end ist exklusiv, alle Teile sind optional$..book[1:3], $..book[::2] oder $..book[-2:]
[?(expr)]Filter: behält Kinder, für die der Ausdruck wahr ist; @ ist das aktuelle Kind$..book[?(@.price < 10)]
[?(@.key)]Existenztest$..book[?(@.isbn)]
== != < <= > >=Vergleiche (Zahlen mit Zahlen, Strings mit Strings)[?(@.category == 'fiction')]
&& || ! und ( )Logisches Und, Oder, Nicht, Gruppierung[?(@.price > 5 && [email protected])]
=~ /re/iTest mit regulärem Ausdruck (Jayway/Goessner-Erweiterung)[?(@.author =~ /^J/)]
length() count() match() search() value()RFC-9535-Funktionen[?(length(@.tags) > 2)], [?match(@.code, '[A-Z]{3}')]

So funktioniert die Auswertung

Ein JSONPath-Ausdruck ist eine Kette von Segmenten. Die Auswertung beginnt mit einer Liste, die nur den Wurzelwert enthält. Jedes Segment nimmt jeden Knoten der aktuellen Liste und ersetzt ihn durch die Knoten, die seine Selektoren auswählen, sodass die Liste wachsen (Wildcards, rekursiver Abstieg) oder schrumpfen (Namen, Indizes, Filter) kann. Die finale Liste ist das Ergebnis, immer in Dokumentreihenfolge. Dieser Tester folgt RFC 9535: Eine fehlende Eigenschaft oder ein Index außerhalb des Bereichs ergibt einfach keinen Treffer statt eines Fehlers, und Vergleiche zwischen verschiedenen Typen (etwa "10" < 20) sind falsch.

Innerhalb eines Filters bezieht sich @ auf das geprüfte Kind und $ weiterhin auf die Dokumentwurzel, sodass du mit anderen Werten vergleichen kannst, zum Beispiel $..book[?(@.price > $.expensive)]. Ein Vergleichsoperand muss einen einzelnen Wert auswählen; ein Pfad, der nichts findet, wird als "nichts" verglichen, was nur einem anderen "nichts" gleicht.

Unterschiede zwischen JSONPath-Implementierungen

  • Filter-Syntax. Goessners ursprüngliche Syntax und Jayway (Java) verwenden [?(@.a)]. RFC 9535 akzeptiert auch [[email protected]]. Hier funktioniert beides.
  • Skript-Ausdrücke wie [(@.length-1)] führten in frühen Bibliotheken beliebiges JavaScript aus und wurden aus dem Standard gestrichen. Verwende stattdessen [-1].
  • Form des Ergebnisses. Manche Bibliotheken liefern einen einzelnen Wert statt eines Arrays, wenn genau ein Knoten passt. Standard-JSONPath liefert immer eine Liste (Knotenliste), und genau die zeigt der Tab Ergebnis.
  • Regex. =~ ist eine Jayway-Erweiterung; die portablen RFC-9535-Entsprechungen sind match() (ganzer String) und search() (Teilstring).

Häufige Fragen

Was ist JSONPath?

JSONPath ist eine Abfragesprache zum Auswählen von Werten in einem JSON-Dokument, ähnlich wie XPath für XML. Sie wurde 2007 von Stefan Goessner eingeführt und 2024 von der IETF als RFC 9535 standardisiert. Ein Ausdruck beginnt immer an der Wurzel $ und geht mit Segmenten wie .store.book[0] nach unten.

Was ist der Unterschied zwischen . und .. in JSONPath?

Ein einzelner Punkt wählt ein direktes Kind aus, $.store.book geht also jeweils nur eine Ebene tiefer. Zwei Punkte sind der rekursive Abstieg: $..author findet jede author-Eigenschaft in beliebiger Tiefe des Dokuments.

Wie schreibe ich einen JSONPath-Filter?

Verwende [?( )], wobei @ für den aktuellen Eintrag steht, zum Beispiel $.store.book[?(@.price < 10)] oder $..book[?(@.category == 'fiction' && @.price > 10)]. RFC 9535 erlaubt auch die Form ohne Klammern: [[email protected] < 10]. Ein Pfad allein, wie [?(@.isbn)], behält Einträge, die diese Eigenschaft haben.

Wie bekomme ich das letzte Element eines Arrays?

Verwende einen negativen Index: $..book[-1] liefert das letzte Buch. Auch Slices akzeptieren negative Werte: [-2:] liefert die letzten beiden Einträge. Die alte Skript-Syntax [(@.length-1)] ist nicht Teil von RFC 9535 und wird hier nicht unterstützt.

Was ist ein normalisierter Pfad?

Ein normalisierter Pfad ist die eindeutige, vollständig in Klammern geschriebene Position eines gefundenen Werts, etwa $['store']['book'][2]['title']. Es ist das von RFC 9535 definierte Format und praktisch zum Protokollieren oder um auf genau einen Wert zu verweisen.

Warum liefert mein Ausdruck nichts?

Häufige Ursachen sind ein Tippfehler in einem Eigenschaftsnamen (Namen unterscheiden Groß- und Kleinschreibung), . statt .. für eine tiefer liegende Eigenschaft, der Vergleich einer Zahl mit einem String ("10" ist nicht gleich 10) oder ein Filter, der auf ein Objekt angewendet wird, obwohl du dessen Array gemeint hast. Sieh im Tab Hervorgehoben nach, wo die Daten wirklich liegen.

Wird mein JSON an einen Server gesendet?

Nein. Die JSONPath-Engine ist in JavaScript geschrieben und läuft in deinem Browser, deine Daten verlassen also nie dein Gerät.

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 →