Darmowy tester JSONPath — wyrażenia online

Czym jest tester JSONPath?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

Kluczowe funkcje

Opracowane przykłady

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

Jak używać testera JSONPath

1. 1

   Wklej lub wczytaj swój JSON

   Przeciągnij JSON do pola wejściowego, wklej go lub kliknij Wczytaj, aby załadować plik .json / .txt z dysku. Formatuj JSON ponownie wcina dokument. Niepoprawny JSON jest oznaczany w miejscu komunikatem parsera, zanim wykonasz zapytanie.

2. 2

   Wybierz silnik

   RFC 9535 (standard IETF z 2024 roku, bez eval) jest domyślny. Przełącz na Classic (Goessner), gdy uruchamiasz wyrażenie skopiowane ze starszego narzędzia, takiego jak jsonpath.com, aby wyniki zgadzały się z tym, co tam widziałeś.

3. 3

   Wpisz swoje wyrażenie JSONPath

   Wiodący $ jest pokazany za ciebie. Zacznij od ścieżki dziecka, jak .store.book[*].title, indeksu, jak [0], rekurencyjnego zejścia, jak ..author, lub filtra, jak [?(@.price < 10)]. Wyniki aktualizują się na żywo w trakcie pisania.

4. 4

   Przełącz widok wyniku

   Wartości pokazują tablicę JSON dopasowanych wartości. Ścieżki pokazują ścieżkę znormalizowaną każdego dopasowania, jak $['store']['book'][0]['title']. Oba pokazują je obok siebie, dzięki czemu możesz odwzorować każdą wartość na jej dokładną lokalizację w dokumencie.

5. 5

   Skopiuj wynik lub udostępnij link bezpośredni

   Kopiuj wynik umieszcza wyjście w schowku. Kopiuj link koduje JSON, wyrażenie, silnik i widok do fragmentu hash adresu URL (bez wysyłania), dzięki czemu współpracownik może odtworzyć dokładne zapytanie lokalnie na własnej maszynie.

Częste błędy w JSONPath

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

Kto używa tego narzędzia

Wyciąganie pól z odpowiedzi API

Wyciągnij identyfikatory żądań, zagnieżdżone atrybuty zasobów lub listę nazw z ładunku JSON bez pisania kodu przechodzenia. Zbuduj ścieżkę tutaj na przykładowej odpowiedzi, potwierdź w widoku Wartości, że zwraca dokładnie te węzły, których chcesz, a potem wklej zweryfikowane wyrażenie do swojej aplikacji lub testu.

Pisanie asercji do testów integracyjnych

Wiele frameworków testowych i narzędzi do testowania kontraktów (REST Assured, Karate, Postman) używa JSONPath do asercji na ciałach odpowiedzi. Naszkicuj ścieżkę asercji tutaj, sprawdź, że wybiera właściwy węzeł względem prawdziwej odpowiedzi, i skopiuj ją do testu — łapiąc błędną ścieżkę, zanim zestaw stanie się czerwony.

Konfigurowanie przekształceń danych w potokach

Kubernetes, AWS Step Functions, Azure Logic Apps i wiele narzędzi ETL akceptuje JSONPath do adresowania pól w ładunkach zdarzeń. Prototypuj dokładną ścieżkę względem reprezentatywnego zdarzenia tutaj, potwierdź, że się rozwiązuje, i umieść ją w konfiguracji swojego potoku z pewnością, że wskazuje tam, gdzie zamierzasz.

Odtwarzanie wyniku z jsonpath.com prywatnie

Masz wyrażenie z ewaluatora opartego na serwerze, ale nie możesz wkleić swoich danych do strony trzeciej? Przełącz na tryb Classic (Goessner), załaduj swój JSON i odtwórz ten sam wynik lokalnie — żaden ładunek nigdy nie opuszcza twojej przeglądarki, więc zastrzeżone dane pozostają na twojej maszynie.

Migracja starszych wyrażeń do RFC 9535

Przechodzisz do systemu deklarującego zgodność z RFC 9535? Uruchom starsze wyrażenie w trybie Classic, a następnie przełącz na silnik RFC 9535, aby zobaczyć, czy wciąż się parsuje i dopasowuje te same węzły. Porównanie dwóch silników wskazuje różnice w filtrach, uniach i funkcjach, na które inaczej natknąłbyś się na produkcji.

Debugowanie, dlaczego ścieżka zwraca błędne węzły

Ścieżka, która wybiera zbyt wiele lub zbyt mało, jest trudna do przeanalizowania na podstawie samych wartości. Przełącz na widok Ścieżki, aby zobaczyć znormalizowaną lokalizację każdego dopasowania — dokładny indeks tablicy, dokładny łańcuch składników — a błąd wycinka o jeden lub zabłąkane rekurencyjne zejście stanie się natychmiast oczywiste.

Nauczanie lub recenzowanie JSONPath

Otwórz działające wyrażenie na przykładowych danych i przejdź przez nie selektor po selektorze, przełączając między Wartości i Ścieżki, aby uczący się widział zarówno to, co jest wybierane, jak i gdzie się znajduje. Ściąga i opracowane przykłady dają ustrukturyzowane odniesienie do recenzji kodu lub wdrażania.

Uwagi o silniku i algorytmie

Silnik RFC 9535 (jsonpath-rfc9535, bez zależności)

Domyślny silnik implementuje gramatykę IETF RFC 9535 bezpośrednio: tokenizuje i parsuje wyrażenie do abstrakcyjnego drzewa składniowego oraz interpretuje je względem dokumentu. Nigdzie na ścieżce nie ma eval ani konstruktora Function, więc jest odporny na klasę błędów wstrzykiwania eval i działa pod ścisłą Content-Security-Policy.

Silnik Classic (jsonpath-plus, eval wyłączony)

Silnik Classic (Goessner) to jsonpath-plus przypięty do załatanego wydania (>= 10.4.0) i skonstruowany z opcją eval jawnie ustawioną na false. To zachowuje zgodność z dialektem Goessnera, jednocześnie zamykając wektory zdalnego wykonania kodu śledzone jako CVE-2024-21534 i CVE-2025-1302, które dotyczyły domyślnej ścieżki filtra biblioteki opartej na eval.

Generowanie ścieżek znormalizowanych

Każde dopasowanie jest raportowane ze swoją ścieżką znormalizowaną RFC 9535 — formą kanoniczną używającą notacji nawiasowej z pojedynczymi cudzysłowami ($['store']['book'][0]['title']) z indeksami tablic jako gołymi liczbami całkowitymi. Ścieżki znormalizowane są stabilne i unikalne dla węzła, więc równoważne wyrażenia dają identyczne ścieżki, na czym widoki Ścieżki i Oba opierają jednoznaczną identyfikację wyniku.

Leniwie ładowane fragmenty silników

Oba silniki są ładowane jako osobne fragmenty JavaScriptu dopiero przy pierwszym wyborze, dzięki czemu początkowa strona pozostaje lekka, a silnik, którego nie używasz, nigdy nie jest pobierany. Przełączenie silników natychmiast ponownie ewaluuje bieżące wyrażenie względem bieżącego dokumentu, bez przeładowania strony.

Lokalne odczytywanie plików i formatowanie JSON

Przycisk Wczytaj używa przeglądarkowego API FileReader do odczytania pliku .json lub .txt do wejścia w całości po stronie klienta — plik nigdy nie jest przesyłany. Formatuj JSON parsuje i ponownie serializuje wejście z wcięciem dwóch spacji, ujawniając błędy parsowania w miejscu, dzięki czemu zniekształcony JSON jest łapany przed ewaluacją.

Linki bezpośrednie przez fragment hash URL (nigdy nie przesyłane)

Stan udostępniania jest kodowany we fragmencie location.hash, niosąc JSON, wyrażenie, aktywny silnik i widok wyniku. Przeglądarki nigdy nie dołączają fragmentu do żądań HTTP, więc serwery go-tools.org otrzymują zero danych przy otwarciu linku bezpośredniego; nawadnianie odbywa się w całości na urządzeniu odbiorcy.

Najlepsze praktyki JSONPath

Wybierz silnik pasujący do twojego celu

Jeśli twój system docelowy deklaruje zgodność z RFC 9535, pisz i weryfikuj względem silnika RFC 9535. Jeśli odtwarzasz lub utrzymujesz wyrażenie ze starszego narzędzia lub biblioteki, użyj Classic (Goessner). Walidacja względem błędnego dialektu to najczęstszy powód, dla którego ścieżka, która działała w testerze, zawodzi na produkcji.

Weryfikuj widokiem Ścieżki, nie tylko Wartości

Widok Wartości mówi ci, co się dopasowało; widok Ścieżki mówi, gdzie. Gdy zapytanie zwraca poprawnie wyglądające wartości, może i tak wybierać je z błędnej lokalizacji — zabłąkane rekurencyjne zejście lub zbyt szeroki symbol wieloznaczny. Sprawdź ścieżki znormalizowane, aby potwierdzić, że wyrażenie trafia dokładnie w te węzły, które zamierzasz.

Pamiętaj o wyłącznym końcu wycinka

[0:2] wybiera indeksy 0 i 1, nie 0 do 2 — górna granica jest wyłączna, tak jak w Pythonie i JavaScripcie. Błędy wycinka o jeden to najczęstszy błąd JSONPath. Użyj widoku Ścieżki, aby odczytać dokładny indeks każdego wybranego elementu i potwierdzić granicę, zanim wyślesz.

Preferuj jawną ścieżkę nad rekurencyjnym zejściem, gdy możesz

$..price jest wygodne, ale dopasowuje każdą cenę gdziekolwiek w dokumencie, w tym te, których nie zamierzałeś. Gdy znasz strukturę, wypisz ścieżkę ($.store.book[*].price), aby zapytanie pozostało precyzyjne i przewidywalne w miarę wzrostu danych. Zarezerwuj .. dla naprawdę nieregularnych lub nieznanych kształtów.

Zachowuj spójne białe znaki i cudzysłowy w filtrach

RFC 9535 dokładnie trzyma się swojej gramatyki dla wyrażeń filtrujących, podczas gdy klasyczny dialekt jest luźniejszy. Pisz filtry czysto — ujmuj literały łańcuchowe w pojedyncze cudzysłowy ('fiction'), zachowuj odstępy wokół operatorów i unikaj polegania na pobłażliwym parsowaniu — aby to samo wyrażenie ewaluowało się tak samo niezależnie od tego, który silnik lub biblioteka ostatecznie je uruchomi.

Najczęściej zadawane pytania