JSON mit einem JSON-Pfad auswerten

Überblick

Der JSON Path Tester hilft Ihnen dabei, Werte aus einem JSON-Text anhand eines JSON-Pfads zu finden. Das ist nützlich, wenn Sie die Struktur einer JSON-Antwort prüfen oder gezielt einzelne Eigenschaften, Listeneinträge und mehrere passende Werte untersuchen möchten.

Sie geben den JSON-Text und den gewünschten Pfad als Text ein. Für Objekte können Sie Eigenschaften mit durch Punkten getrennten Pfadteilen ansprechen. Eine Wildcard kann Werte in Objekten oder Einträge in Listen durchlaufen. Für Listen stehen außerdem Ausdrücke für einzelne Indizes und Indexbereiche zur Verfügung.

Schritte

Bereiten Sie einen gültigen JSON-Text vor, zum Beispiel ein Objekt mit verschachtelten Eigenschaften oder eine Liste. Fügen Sie ihn in das Eingabefeld für JSON ein.
Tragen Sie den JSON-Pfad als Text ein. Verwenden Sie Punkte zwischen Objekteigenschaften. Für Listeneinträge können Sie einen Index oder einen Indexbereich in der vorgesehenen Klammersyntax angeben. Eine Wildcard eignet sich, wenn Sie Werte aus mehreren Objekteigenschaften oder Listeneinträgen durchlaufen möchten.
Starten Sie die Auswertung. Bei einer erfolgreichen Verarbeitung zeigt das Ergebnis die gefundenen Werte, deren Anzahl und den übergebenen Pfad. Auch ein gültiger JSON-Text mit einem syntaktisch passenden Pfad kann erfolgreich verarbeitet werden, wenn keine Werte zu diesem Pfad vorhanden sind.
Prüfen Sie bei einem fehlgeschlagenen Ergebnis zuerst den JSON-Text. Enthalten JSON-Eingabe und Pfad jeweils Zeichen außer Leerraum, führt ungültiges JSON zu einem nicht erfolgreichen Ergebnis. Ist die JSON-Eingabe oder der Pfad dagegen leer oder besteht nur aus Leerzeichen, wird die Verarbeitung zuerst beendet und es werden erfolgreich keine Treffer gemeldet.
Kontrollieren Sie bei ungewöhnlichem Verhalten außerdem die Pfadschreibweise. Fehlerhafte Klammersyntax für Indizes oder Bereiche und andere ungültige Pfade werden nicht in jedem Fall als reguläres fehlgeschlagenes Ergebnis ausgegeben; mitunter fehlt dann die normale Ergebnisstruktur.

Ergebnisse richtig einordnen

Ein erfolgreiches Ergebnis mit Treffern bedeutet, dass Werte anhand des eingegebenen Pfads gefunden wurden. Die Anzahl bezieht sich auf die gemeldeten Werte, während der angezeigte Pfad die von Ihnen übergebene Pfadangabe wiedergibt. Ein erfolgreiches Ergebnis ohne Treffer ist davon zu unterscheiden: Die Verarbeitung war möglich, aber der Pfad führte zu keinem Wert.

Ein leerer JSON-Text oder ein leerer Pfad ist kein Beleg dafür, dass die Struktur geprüft wurde. In diesem Fall meldet das Werkzeug erfolgreich keine Treffer. Bei ungültigem JSON sollten Sie die Syntax korrigieren und erneut auswerten, sofern auch der Pfad nicht leer ist. Die verfügbaren Pfadformen bilden nur den dokumentierten Funktionsumfang ab und sind nicht als Unterstützung sämtlicher JSONPath-Ausdrücke oder als vollständiger JSONPath-Standard zu verstehen.

Praktisches Beispiel

Sie möchten aus einem verschachtelten Kundenobjekt gezielt den Namen auslesen.

Geben Sie den JSON-Text {"kunde":{"name":"Mira"}} ein und verwenden Sie den Pfad kunde.name. Starten Sie anschließend die Auswertung und prüfen Sie die gemeldete Ergebnisstruktur.

Das Ergebnis meldet bei erfolgreicher Verarbeitung den gefundenen Wert, die Anzahl der gefundenen Werte und den übergebenen Pfad.

Einschränkungen

Der dokumentierte Umfang deckt nur die unterstützten Pfadformen ab. Nicht jede JSONPath-Schreibweise ist erfasst, und fehlerhafte Pfade liefern nicht in jedem Fall eine normale Fehlermeldung.

Häufige Fehler

Fehler: Sie prüfen nur das Ergebnis, obwohl JSON oder Pfad fehlerhaft ist. Korrektur: Verwenden Sie gültiges JSON, prüfen Sie die Pfadteile sowie die Klammersyntax für Indizes und Bereiche und starten Sie die Auswertung erneut.

Häufige Fragen

Was passiert bei einer leeren Eingabe?

Wenn die JSON-Eingabe oder der Pfad leer ist oder nur aus Leerzeichen besteht, wird die Verarbeitung erfolgreich ohne Treffer beendet.

Welche Informationen enthält ein erfolgreiches Ergebnis?

Bei gültigem JSON und einem Pfad, der normal verarbeitet wird, sehen Sie die gefundenen Werte, deren Anzahl und den übergebenen Pfad. Bleibt der Pfad ohne Treffer, ist das Ergebnis dennoch erfolgreich.

Wie gehe ich mit einem Fehler bei JSON oder Pfad um?

Wenn JSON-Eingabe und Pfad beide nicht nur aus Leerzeichen bestehen, führt ungültiges JSON zu einem nicht erfolgreichen Ergebnis. Eine fehlerhafte Pfadangabe kann dagegen je nach Form auch ohne die normale Ergebnisstruktur scheitern.