Tester JSONPath gratuito — Valuta query online

Cos'è un 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

Caratteristiche principali

Esempi svolti

$.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"]

Come usare il tester JSONPath

1. 1

   Incolla o carica il tuo JSON

   Trascina il JSON nella casella di input, incollalo, oppure fai clic su Carica per aprire un file .json / .txt dal disco. Formatta JSON re-indenta il documento. Il JSON non valido viene segnalato in linea con un messaggio del parser prima dell'interrogazione.

2. 2

   Scegli un motore

   RFC 9535 (lo standard IETF del 2024, senza eval) è il predefinito. Passa a Classic (Goessner) quando esegui un'espressione copiata da uno strumento più vecchio come jsonpath.com così i risultati corrispondono a ciò che hai visto lì.

3. 3

   Digita la tua espressione JSONPath

   Il $ iniziale è mostrato per te. Inizia con un percorso figlio come .store.book[*].title, un indice come [0], una discesa ricorsiva come ..author, oppure un filtro come [?(@.price < 10)]. I risultati si aggiornano in tempo reale mentre digiti.

4. 4

   Cambia la vista dei risultati

   Valori mostra un array JSON dei valori corrispondenti. Percorsi mostra il percorso normalizzato di ogni corrispondenza come $['store']['book'][0]['title']. Entrambi li mostra affiancati così puoi mappare ogni valore alla sua posizione esatta nel documento.

5. 5

   Copia il risultato o condividi un permalink

   Copia risultato porta l'output nei tuoi appunti. Copia link codifica il JSON, l'espressione, il motore e la vista in un hash dell'URL (nessun upload) così un collega può riprodurre la query esatta localmente sulla propria macchina.

Errori JSONPath comuni

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

Chi usa questo strumento

Estrarre campi da una risposta API

Estrai ID di richieste, attributi di risorse annidate o un elenco di nomi da un payload JSON senza scrivere codice di attraversamento. Costruisci il percorso qui su una risposta campione, conferma che restituisce esattamente i nodi che vuoi nella vista Valori, poi incolla l'espressione validata nella tua applicazione o nel tuo test.

Scrivere asserzioni per i test di integrazione

Molti framework di test e strumenti di contract testing (REST Assured, Karate, Postman) usano JSONPath per fare asserzioni sui corpi delle risposte. Bozza il percorso dell'asserzione qui, verifica che selezioni il nodo giusto su una risposta reale e copialo nel tuo test — intercettando un percorso sbagliato prima che la suite diventi rossa.

Configurare trasformazioni di dati nelle pipeline

Kubernetes, AWS Step Functions, Azure Logic Apps e molti strumenti ETL accettano JSONPath per indirizzare i campi nei payload di eventi. Prototipa il percorso esatto su un evento rappresentativo qui, conferma che si risolve e inseriscilo nella configurazione della tua pipeline con la certezza che punti dove intendi.

Riprodurre un risultato di jsonpath.com in privato

Hai un'espressione da un valutatore basato su server ma non puoi incollare i tuoi dati in un sito di terze parti? Passa alla modalità Classic (Goessner), carica il tuo JSON e riproduci lo stesso risultato localmente — nessun payload lascia mai il tuo browser, quindi i dati proprietari restano sulla tua macchina.

Migrare espressioni legacy a RFC 9535

Stai passando a un sistema che dichiara conformità a RFC 9535? Esegui un'espressione legacy in modalità Classic, poi passa al motore RFC 9535 per vedere se viene ancora analizzata e corrisponde agli stessi nodi. Il confronto a doppio motore individua le differenze di filtri, unioni e funzioni che altrimenti incontreresti in produzione.

Eseguire il debug del perché un percorso restituisce i nodi sbagliati

Un percorso che seleziona troppo o troppo poco è difficile da capire dai soli valori. Passa alla vista Percorsi per vedere la posizione normalizzata di ogni corrispondenza — l'indice esatto dell'array, la catena esatta di membri — e l'off-by-one nello slice o la discesa ricorsiva di troppo diventa subito evidente.

Insegnare o revisionare JSONPath

Apri un'espressione funzionante su dati campione e percorrila selettore per selettore, passando tra Valori e Percorsi così chi impara vede sia cosa viene selezionato sia dove vive. Il prontuario e gli esempi svolti offrono un riferimento strutturato per la code review o l'onboarding.

Note su motore e algoritmo

Motore RFC 9535 (jsonpath-rfc9535, senza dipendenze)

Il motore predefinito implementa direttamente la grammatica RFC 9535 dell'IETF: tokenizza e analizza l'espressione in un albero di sintassi astratto e la interpreta rispetto al documento. Non c'è alcun eval né costruttore Function in tutto il percorso, quindi è immune dalla classe di bug di iniezione tramite eval e gira sotto una Content-Security-Policy rigorosa.

Motore Classic (jsonpath-plus, eval disabilitato)

Il motore Classic (Goessner) è jsonpath-plus, fissato a una release con patch (>= 10.4.0) e costruito con l'opzione eval impostata esplicitamente su false. Questo mantiene la compatibilità con il dialetto Goessner chiudendo al contempo i vettori di esecuzione di codice remoto tracciati come CVE-2024-21534 e CVE-2025-1302, che interessavano il percorso di filtro predefinito della libreria basato su eval.

Generazione del percorso normalizzato

Ogni corrispondenza viene riportata con il suo percorso normalizzato RFC 9535 — una forma canonica che usa la notazione a parentesi con virgolette singole ($['store']['book'][0]['title']) con gli indici di array come interi nudi. I percorsi normalizzati sono stabili e univoci per nodo, quindi espressioni equivalenti producono percorsi identici, su cui le viste Percorsi ed Entrambi si basano per un'identificazione inequivocabile dei risultati.

Chunk dei motori a caricamento differito

Entrambi i motori vengono caricati come chunk JavaScript separati solo quando selezionati per la prima volta, così la pagina iniziale resta leggera e il motore che non usi non viene mai scaricato. Il cambio di motore rivaluta immediatamente l'espressione corrente rispetto al documento corrente, senza ricaricare la pagina.

Lettura di file locali e formattazione JSON

Il pulsante Carica usa l'API FileReader del browser per leggere un file .json o .txt nell'input interamente lato client — il file non viene mai trasmesso. Formatta JSON analizza e riserializza l'input con un'indentazione di due spazi, facendo emergere gli errori di parsing in linea così il JSON malformato viene intercettato prima della valutazione.

Permalink tramite hash dell'URL (mai trasmesso)

Lo stato di condivisione è codificato nel frammento location.hash, che trasporta il JSON, l'espressione, il motore attivo e la vista dei risultati. I browser non includono mai il frammento nelle richieste HTTP, quindi i server di go-tools.org ricevono zero dati quando si apre un permalink; la ricostruzione avviene interamente sul dispositivo del destinatario.

Best practice JSONPath

Scegli il motore che corrisponde al tuo obiettivo

Se il tuo sistema a valle dichiara conformità a RFC 9535, scrivi e valida rispetto al motore RFC 9535. Se stai riproducendo o mantenendo un'espressione di uno strumento o di una libreria più vecchi, usa Classic (Goessner). Validare rispetto al dialetto sbagliato è la ragione più comune per cui un percorso che funzionava nel tester fallisce in produzione.

Verifica con la vista Percorsi, non solo con i Valori

La vista Valori ti dice cosa ha corrisposto; la vista Percorsi ti dice dove. Quando una query restituisce valori dall'aspetto giusto, potrebbe comunque selezionarli dalla posizione sbagliata — una discesa ricorsiva di troppo o un jolly troppo ampio. Controlla i percorsi normalizzati per confermare che l'espressione colpisce esattamente i nodi che intendi.

Attenzione al limite finale esclusivo di uno slice

[0:2] seleziona gli indici 0 e 1, non da 0 a 2 — il limite finale è esclusivo, proprio come in Python e JavaScript. Gli errori di off-by-one negli slice sono il bug JSONPath più frequente. Usa la vista Percorsi per leggere l'indice esatto di ogni elemento selezionato e conferma il limite prima del rilascio.

Preferisci un percorso esplicito alla discesa ricorsiva quando puoi

$..price è comodo ma corrisponde a ogni price ovunque nel documento, inclusi quelli che non intendevi. Quando conosci la struttura, specifica il percorso ($.store.book[*].price) così la query resta precisa e prevedibile man mano che i dati crescono. Riserva .. per forme genuinamente irregolari o sconosciute.

Mantieni coerenti spazi e virgolette nei filtri

RFC 9535 segue la sua grammatica con esattezza per le espressioni di filtro, mentre il dialetto classico è più permissivo. Scrivi i filtri in modo pulito — racchiudi i valori letterali stringa tra virgolette singole ('fiction'), tieni gli operatori spaziati ed evita di affidarti al parsing indulgente — così la stessa espressione viene valutata allo stesso modo indipendentemente da quale motore o libreria la eseguirà alla fine.

Domande frequenti