Vai al contenuto
SPCX Tools

Tester JSONPath

Valuta e testa le espressioni JSONPath sui tuoi dati JSON istantaneamente nel browser.

Funziona localmente: i file non lasciano mai il tuo dispositivo

Caricamento strumento…

Come usare Tester JSONPath

  1. 1Incolla o digita i tuoi dati JSON nel pannello di sinistra, oppure fai clic su "Esempio" per caricare dei dati di prova.
  2. 2Inserisci la tua espressione JSONPath nel campo di input in cima alla pagina.
  3. 3Fai clic su uno dei pulsanti di esempio rapido sotto l'input per vedere in azione i pattern di query più comuni.
  4. 4Visualizza i risultati corrispondenti, il numero totale di corrispondenze e i percorsi esatti degli elementi trovati nel pannello di destra.

Un tester JSONPath veloce e privato

Quando si lavora con dati JSON di grandi dimensioni o profondamente nidificati, estrarre le informazioni esatte può essere macchinoso. Questo tester JSONPath offre un ambiente in tempo reale per scrivere, testare ed eseguire il debug delle tue query. Mentre digiti l'espressione, lo strumento la valuta all'istante sul tuo payload JSON, mostrandoti sia i valori estratti che i percorsi esatti in cui sono stati trovati.

Trattandosi di un valutatore JSONPath interamente lato client, l'elaborazione avviene solo localmente sul tuo dispositivo. I tuoi dati JSON non vengono mai inviati a un server. Questo significa che puoi incollare in totale sicurezza payload di API in produzione, esportazioni di database o file di configurazione sensibili, senza preoccuparti di fughe di dati o violazioni della privacy.

Funzionalità principali per gli sviluppatori

  • Valutazione in tempo reale: I risultati si aggiornano immediatamente non appena modifichi i dati JSON o la query. Non serve cliccare su alcun pulsante di invio o attendere la risposta di un server.
  • Parsing sicuro: Lo strumento utilizza un motore di valutazione sicuro (eval: 'safe') per elaborare le query, impedendo l'esecuzione di codice dannoso ma mantenendo il pieno supporto per le espressioni di filtro complesse.
  • Estrazione dei percorsi: Oltre a mostrare i valori trovati, lo strumento genera i percorsi assoluti per ogni corrispondenza. È una funzione estremamente utile se in seguito devi aggiornare quei nodi specifici a livello di codice.
  • Esempi integrati: Se non hai familiarità con la sintassi, puoi caricare il dataset di esempio di una libreria e provare diverse espressioni preimpostate per capire il funzionamento dei vari operatori.

Come scrivere una query JSONPath

JSONPath utilizza una sintassi specifica per navigare tra gli oggetti e gli array JSON. Se vuoi testare la logica di un'espressione JSONPath, è utile conoscerne gli operatori fondamentali:

  • $ rappresenta l'oggetto o l'array radice. Ogni espressione JSONPath assoluta inizia con questo simbolo.
  • @ rappresenta il nodo corrente in fase di elaborazione. Viene utilizzato principalmente all'interno delle espressioni di filtro.
  • . o [] sono operatori figlio usati per selezionare le proprietà. Ad esempio, $.store.book e $['store']['book'] hanno la stessa funzione.
  • .. è l'operatore di discesa ricorsiva. Cerca una chiave specifica ovunque nell'albero JSON, indipendentemente dal livello di annidamento (es. $..price trova tutti i prezzi).
  • * è un carattere jolly (wildcard) che corrisponde a tutti gli elementi di un oggetto o array. Ad esempio, $.store.* seleziona tutto ciò che si trova direttamente all'interno dell'oggetto store.
  • [?()] applica un'espressione di filtro. Al suo interno puoi usare gli operatori logici standard. Ad esempio, $..book[?(@.author == 'Nigel Rees')] troverà tutti i libri scritti da quello specifico autore.
  • [start:end:step] consente di effettuare lo slicing degli array, in modo simile a Python. $.store.book[-1:] seleziona l'ultimo libro dell'array.

Casi d'uso comuni

Sviluppo e debug di API. Le moderne API REST e GraphQL restituiscono spesso enormi payload JSON. Invece di scrivere codice temporaneo per analizzare e ispezionare la risposta, puoi incollare il payload in questo strumento JSONPath online per verificare rapidamente che la struttura dei dati sia corretta e che le tue query estraggano i campi giusti.

Test automatizzati. Quando scrivi test di integrazione o end-to-end (usando strumenti come Postman, RestAssured o Playwright), hai spesso bisogno di verificare che valori specifici esistano in una risposta JSON. Usare un tester JSONPath ti aiuta a perfezionare la stringa di query prima di inserirla nel codice della tua suite di test.

Estrazione e trasformazione dei dati. Se stai migrando dati o creando pipeline ETL (Extract, Transform, Load), spesso hai bisogno di isolare array o oggetti specifici. Puoi usare questo strumento per individuare i percorsi esatti necessari per estrarre i dati desiderati. Se i dati di origine sono in XML, puoi prima usare il convertitore XML in JSON, e se hai bisogno di formattare dati minificati prima di ispezionarli, il JSON Formatter può esserti d'aiuto. Puoi anche usare lo strumento JSON Compare per vedere come cambiano i dati prima e dopo le trasformazioni.

Domande frequenti

Cos'è JSONPath?
JSONPath è un linguaggio di interrogazione per dati JSON, simile a XPath per XML. Ti permette di selezionare ed estrarre nodi, array o valori specifici da una struttura JSON complessa utilizzando un'espressione compatta.
I miei dati JSON sono al sicuro?
Sì. Questo strumento viene eseguito interamente in locale nel tuo browser. I tuoi dati JSON e le tue query non vengono mai caricati su alcun server, rendendolo perfettamente sicuro per testare risposte API sensibili, file di configurazione o dati proprietari.
Come posso filtrare i dati in base a una condizione specifica?
Puoi utilizzare un'espressione di filtro con la sintassi [?(@.property == 'value')]. Ad esempio, $.store.book[?(@.price < 10)] restituirà tutti i libri nell'array store che hanno un prezzo strettamente inferiore a 10.
Posso vedere la posizione esatta degli elementi corrispondenti?
Sì. Sotto i risultati principali, è presente una sezione espandibile "Paths". Aprendola, verrà mostrato il JSONPath esatto e assoluto per ogni singolo elemento trovato.
Perché ricevo un errore "Invalid JSON"?
Il formato JSON richiede una formattazione rigorosa. Assicurati che tutte le chiavi e i valori stringa siano racchiusi tra virgolette doppie (non singole) e che non ci siano virgole finali dopo l'ultimo elemento di un oggetto o di un array.
Quale specifica JSONPath utilizza questo strumento?
Questo strumento utilizza la popolare libreria jsonpath-plus, che supporta pienamente la specifica JSONPath originale aggiungendo alcune funzionalità estese e sicure per query più complesse. Valuta le espressioni in modo sicuro senza utilizzare la funzione JavaScript eval().