JSONPath Evaluator

So verwendest du den JSONPath-Auswerter

1. Füge das JSON-Dokument in den linken Eingabebereich ein. Der Parser ist streng RFC 8259, sodass abschließende Kommas, einfache Anführungszeichen, JS-artige Kommentare oder irrende BOM-Bytes als Parse-Fehler angezeigt werden, bevor der Pfad überhaupt läuft.
2. Tippe den Pfadausdruck in das zweite Feld, beginnend mit $. Mische Punkt-Notation ($.store.book[0].title) und Klammer-Notation ($['store']['book'][0]['title']) frei; verwende Integer-Indizes, Slice-Bereiche, Wildcards und rekursiven Abstieg, wie die Struktur es erfordert.
3. Drücke "Auswerten", um den Baum zu gehen. Übereinstimmende Werte werden als JSON-Array in Dokumentreihenfolge ausgegeben, auch wenn der Pfad zu einem einzelnen Wert aufgelöst wird.
4. Kopiere das Ergebnis-Panel in dein Test-Fixture, dein Fetch-Skript oder einen anderen Tab. Die vollständige Eingabe und Ausgabe bleiben client-seitig; nichts wird zu ZeroUtil oder anderswohin hochgeladen.

Was der Auswerter intern macht

Der Pfad-String wird in einen kleinen geordneten Strom von Opcodes tokenisiert: root (das führende $), child für Punkt- oder quotierter-Klammer-Zugriff, index für Integer-Subscripts (mit negativer Indizierung für End-relative Offsets), slice für exklusive End-Python-artige Bereiche ([start:end] und [start:end:step]), wildcard für * und recursive für den ..-Doppelpunkt-Operator. Der Walker trägt eine Arbeitsmenge von Knoten durch jeden Opcode, wobei die Menge wächst oder schrumpft, wenn die Operatoren anwenden. Die gesamte Pipeline ist eine einzelne reine Funktion in JsonPathEvaluator.logic.ts mit Unit-Test-Abdeckung, keinen eval-Aufrufen und null Laufzeit-Abhängigkeiten.

Rekursiver Abstieg ($..name) ist der teuerste Operator, weil er jeden Knoten unterhalb der aktuellen Front besucht. Die Implementierung führt einen Tiefendurchlauf in Pre-Order durch und gibt Übereinstimmungen in Dokumentreihenfolge aus, was jede andere JSONPath-Bibliothek tut und dem De-facto-Goessner-Referenzverhalten entspricht. Filter-Ausdrücke wie [?(@.price < 10)] und Script-Ausdrücke wie [(@.length-1)] werden absichtlich nicht unterstützt, weil sie einen sandboxed Ausdrucks-Auswerter erfordern und Fragen über Prädikat-Sicherheit bei feindlicher Eingabe aufwerfen.

Ein bearbeitetes Beispiel, Operator für Operator

Nimm das kanonische Goessner-Buchladen-Dokument und beobachte, wie jeder Operator die Arbeitsmenge einengt oder erweitert:

{
  "store": {
    "book": [
      { "title": "Sayings of the Century", "price": 8.95 },
      { "title": "Moby Dick", "price": 8.99 },
      { "title": "The Lord of the Rings", "price": 22.99 }
    ],
    "bicycle": { "color": "red", "price": 19.95 }
  }
}

• $.store.book[0].title geht Wurzel, dann den store-Kindknoten, dann Index 0 des book-Arrays, dann seinen title. Ergebnis: ["Sayings of the Century"].
• $.store.book[*].price verwendet eine Wildcard, um über jedes Buch zu fächern und gibt [8.95, 8.99, 22.99] in Dokumentreihenfolge zurück.
• $.store.book[-1].title nimmt das letzte Buch durch negativen Index: ["The Lord of the Rings"].
• $.store.book[0:2].title sliced die ersten zwei Bücher (End-exklusiv): ["Sayings of the Century", "Moby Dick"].
• $..price steigt rekursiv ab, sammelt jeden price unterhalb der Wurzel einschließlich des Fahrrads: [8.95, 8.99, 22.99, 19.95].

Die letzte Abfrage ist diejenige, die Leute überrascht. Rekursiver Abstieg besucht den gesamten Teilbaum, nicht nur die erste Übereinstimmung, weshalb er richtig ist für "Finde jede id unabhängig von Verschachtelung" und falsch, wenn du einen einzelnen Knoten gemeint hast.

Wann dieses Tool seinen Wert beweist

• Einen spezifischen Wert aus einem tief verschachtelten Webhook-Payload (Stripe-Events, Shopify-Bestellungen, GitHub-Action-Kontexte) herausziehen, ohne einen Wegwerf-JS-Einzeiler zu schreiben.
• Snapshot-Tests erstellen, bei denen du behaupten möchtest "jede id in diesem OpenAPI-Dokument ist ein String", zuerst als $..id entworfen.
• Einem Teamkollegen erklären, warum seine $.users[*].email-Abfrage ein leeres Array zurückgibt, weil der eigentliche Schlüssel users bei Tiefe 2 ist, nicht Tiefe 1.
• Eine Liste von Dateipfaden aus einem Cloudflare-Pages-Build-Manifest, einer Vercel-Deployment-Antwort oder einem Kubernetes-kubectl -o json-Dump extrahieren.
• Den JSONPath skizzieren, den du in einen Datadog-Monitor, ein Logz.io-Alert oder einen Postman-Test zu setzen gedenkst, bevor du die Konfiguration überträgst.
• Überprüfen, dass ein Long-Tail-JSON-Dokument tatsächlich das Feld enthält, das du bei der Tiefe erwartest, die du angenommen hast, ohne Code zu instrumentieren.

Häufige Fallstricke und Randfälle

• Rekursiver Abstieg ist gierig. $..price auf einem Dokument mit sowohl store.bicycle.price als auch store.book[*].price gibt jede Übereinstimmung zurück, nicht die erste. Wenn du nur die Bücher möchtest, verankere mit $.store.book[*].price.
• Slices sind End-exklusiv. [0:2] gibt Elemente 0 und 1 zurück, nicht 0 bis 2 einschließlich. Das stimmt mit Python und der JSONPath-Referenz überein, verbrennt aber Entwickler, die an inklusive Bereiche gewöhnt sind.
• Negative Indizes wrappen still. [-1] ist das letzte Element, [-100] auf einem 5-Element-Array ist keine Übereinstimmung (kein Fehler). Plane für beide Verhaltensweisen, wenn du Pfade programmatisch generierst.
• Punkt-Notation kann keine Schlüssel mit Punkten darin erreichen. Ein Schlüssel wörtlich namens "file.json" benötigt Klammer-Notation: $['files']['file.json']. Punkt-Syntax würde ihn als verschachtelten Pfad parsen.
• Wildcards auf Objekten iterieren Werte, keine Schlüssel. $.headers.* gibt die Werte jedes Headers in Einfügungsreihenfolge zurück. Es gibt keinen Schlüssel-Introspektions-Operator in der JSONPath-Grammatik.
• Filter-Ausdrücke werden nicht unterstützt. Wenn dein Pfad ?(...) enthält, wechsle zu einer reichhaltigeren Engine wie jsonpath-plus, JMESPath oder jq. Die Auslassung ist absichtlich.

JSONPath-Ursprünge und IETF RFC 9535

JSONPath wurde 2007 von Stefan Goessner als JSON-Analogon zu XPath skizziert. Die Referenzimplementierung war ein JavaScript-Snippet, das Seiten jahrelang ohne formale Spezifikation kopierten. Im Jahr 2024 veröffentlichte die IETF RFC 9535, das erste Standards-Track-JSONPath-Dokument, das Randfälle korrigiert (Unicode-Normalisierung, Leerzeichen-Behandlung, Slice-Semantik) und eine portable Test-Suite definiert. Die hier implementierte Grammatik ist die gemeinsame Teilmenge, auf die sich sowohl Goessner als auch RFC 9535 einigen; reichhaltigere Engines wie Burke Librarys jsonpath-plus, Javas Jayway und Pythons jsonpath-ng fügen Filter- und Script-Ausdrücke hinzu.

Alternativen und wann sie dieses Tool schlagen

Kommandozeilen-jq ist die richtige Wahl für Transformationen statt Extraktionen; es hat eine reichhaltigere Abfragesprache, unterstützt Streaming und läuft auf Gigabytes von Daten ohne den Browser-Speicherdruck. JMESPath (die --query-Flag des AWS CLI) ist eine andere, aber verwandte Grammatik mit stärkerer Filter- und Projektionsunterstützung; wenn du in aws-, az- oder gh-CLIs lebst, bevorzuge es. Innerhalb von Node deckt jsonpath-plus auf npm die Filter-Ausdrücke ab, die dieser Auswerter weglässt. JSON Pointer (RFC 6901) ist die richtige Wahl, wenn du nur einen einzelnen, vollständig angegebenen Pfad ohne Wildcards benötigst. Verwende diesen Auswerter, wenn du einen Pfad interaktiv im Browser entwerfen und überprüfen möchtest, keine andere Abfragesprache installieren oder erlernen möchtest und keine sensitiven Payloads in einen Remote-Dienst wie jsonpath.com einfügen möchtest.