Consulta JSON Pointer

Consulta JSON Pointer: usi e guida pratica

JSON Pointer identifica un valore utilizzando un percorso specifico all'interno di un documento JSON. È utile quando una risposta contiene oggetti e array nidificati, ma è necessario un solo membro. Ogni segmento di percorso inizia con una barra. In /users/0/name, gli utenti selezionano un membro dell'oggetto root, 0 seleziona il primo elemento dell'array e il nome seleziona il membro di quell'elemento. La ricerca non cerca l'intero documento: segue i segmenti in ordine e si arresta con un errore quando un segmento non può essere risolto. Questo distingue un percorso errato da un valore esistente che sembra essere nullo.

Un percorso vuoto seleziona l'intero documento. Una singola barra seleziona un membro dell'oggetto il cui nome è la stringa vuota, se tale membro esiste. Una barra letterale in un nome membro è codificata come 1 all'interno di un segmento; una tilde letterale è codificata come 0. Ad esempio, /a~1b Seleziona il membro a/b. La sequenza 01 rappresenta il testo 1 piuttosto che una barra. Lo spazio bianco del percorso non viene tagliato perché gli spazi possono essere parti significative dei nomi dei membri. I nomi devono corrispondere esattamente: il caso delle lettere non viene ignorato e gli accenti o i diversi moduli di normalizzazione Unicode non vengono trattati come equivalenti.

Gli indici degli array partono da zero e devono essere scritti come interi non negativi senza zeri iniziali. /items/01 non seleziona il secondo elemento. Anche un trattino non viene interpretato come l'ultimo elemento; questa ricerca recupera solo i valori già esistenti. Un nome come costruttore è accessibile solo quando è un membro proprio dell'oggetto JSON, piuttosto che qualcosa ereditato dalla catena di prototipi di JavaScript. L'interfaccia accetta la forma testuale di JSON Pointer, non espressioni JSONPath con caratteri jolly, filtri o segni dollaro, e non la rappresentazione URI-frammento di un puntatore.

L'output conserva il tipo JSON del valore selezionato. Le stringhe appaiono tra virgolette, i numeri rimangono numeri, null rimane nullo, e gli oggetti o gli array sono mostrati come JSON rientrato. Ciò rende i frammenti scaricati interpretabili da un altro programma. Il parsing rifiuta le chiavi duplicate per impedire la selezione ambigua dei membri e gli interi al di fuori dell'intervallo di sicurezza del browser per prevenire la perdita di precisione. Gli identificatori numerici lunghi dovrebbero essere forniti come stringhe dal sistema originario. Input supporta un milione di caratteri, cento livelli di nesting e un numero limitato di elementi per mantenere la pagina reattiva. Per i documenti più grandi, ridurre prima il contenuto mantenendo la struttura necessaria per il percorso selezionato e controllare il valore estratto rispetto alla sorgente originale.