Come estrarre valori da JSON con JSON Path Tester

A cosa serve

JSON Path Tester serve a leggere un testo JSON tramite un’espressione di percorso e a individuare i valori collegati a quella posizione. È utile quando vuoi controllare rapidamente una proprietà annidata, attraversare valori contenuti in oggetti o liste oppure selezionare alcune posizioni di una lista, senza esaminare manualmente l’intera struttura. L’input è facoltativo: se non inserisci testo, viene considerato vuoto. Anche il percorso è facoltativo e, se manca, viene considerato una stringa vuota.

Come usare lo strumento

1. Prepara un JSON valido come testo. Può contenere oggetti, liste e proprietà annidate. Incollalo nel campo dedicato all’input JSON.

2. Scrivi il percorso da verificare nel campo dell’espressione. Per una proprietà annidata puoi usare segmenti separati da punti, come cliente.indirizzo.citta. Il comportamento supporta anche un carattere jolly per attraversare i valori di un oggetto o gli elementi di una lista, oltre a espressioni tra parentesi quadre per indici e intervalli di indici.

3. Avvia l’estrazione con il controllo disponibile nell’interfaccia. Se il testo JSON e il percorso contengono caratteri non vuoti, un JSON non valido porta a un risultato non riuscito. Perciò, quando l’estrazione non parte come previsto, verifica prima parentesi, virgolette, virgole e la struttura del JSON.

4. Leggi il risultato restituito. Quando l’input è valido e il percorso viene elaborato normalmente, il risultato indica i valori trovati, il numero di valori trovati e il percorso fornito. Se il percorso non corrisponde a valori, l’operazione può comunque concludersi correttamente, ma senza corrispondenze.

Come leggere il risultato

Il numero dei risultati indica quante corrispondenze sono state individuate, mentre l’elenco dei valori mostra ciò che è stato recuperato dal percorso. Un risultato riuscito senza corrispondenze non significa che il JSON contenga necessariamente un errore: può indicare che il percorso non coincide con la struttura presente.

Un input vuoto o composto solo da spazi e un percorso vuoto o composto solo da spazi vengono gestiti prima dell’estrazione e producono un risultato riuscito senza corrispondenze. Le espressioni con parentesi quadre o altre forme non valide, invece, non hanno tutte lo stesso comportamento: alcune possono interrompere l’estrazione senza restituire la struttura normale del risultato. Considera quindi il percorso supportato come una sintassi circoscritta, non come l’insieme completo delle espressioni JSONPath.

Esempio pratico

Stai verificando quale valore è associato alla proprietà annidata cliente.nome in un piccolo oggetto JSON.

Incolla {"cliente":{"nome":"Luca","eta":31}}, inserisci il percorso cliente.nome e avvia l’estrazione.

Il risultato riuscito riporta i valori corrispondenti a cliente.nome, il numero di valori trovati e il percorso fornito.

Limiti

• Il comportamento documentato copre un sottoinsieme di forme di percorso. Alcune espressioni malformate possono interrompere l’estrazione senza restituire la struttura normale del risultato.

Errori comuni

• Un JSON con sintassi non valida o un percorso malformato può impedire l’estrazione. Correggi prima la struttura del JSON e poi controlla punti, parentesi quadre, indici e intervalli del percorso.

Domande frequenti

Cosa succede se il percorso non trova alcun valore?

Sì, ma l’esito dipende dal contenuto: con JSON valido e un percorso elaborato normalmente, l’operazione riesce anche quando non trova valori. Se il JSON non è valido e input e percorso contengono testo non vuoto, l’esito è invece non riuscito.

Quali forme di percorso posso usare?

Sì, il comportamento supporta percorsi con proprietà separate da punti, un carattere jolly per attraversare valori di oggetti o elementi di liste e parentesi quadre per indici e intervalli di indici. Non è però stabilito che supporti l’intero standard JSONPath.

Posso lasciare vuoto l’input?

Se il testo JSON o il percorso sono vuoti oppure contengono solo spazi, il risultato è riuscito e non contiene corrispondenze. Questa gestione avviene prima dell’estrazione.