Consulter une valeur avec JSON Pointer

Consulter une valeur avec JSON Pointer: usages et conseils pratiques

JSON Pointer identifie une valeur en utilisant un chemin spécifique dans un document JSON. Il est utile lorsqu'une réponse contient des objets imbriqués et des tableaux, mais vous n'avez besoin que d'un seul membre. Chaque segment de chemin commence par une barre oblique. En /users/0/name, les utilisateurs sélectionnent un membre d'objet racine, 0 sélectionne le premier élément de tableau et le nom sélectionne le membre de cet élément. Lookup ne recherche pas l'ensemble du document : il suit les segments dans l'ordre et s'arrête avec une erreur lorsqu'un segment ne peut pas être résolu. Cela distingue un chemin incorrect d'une valeur existante qui se trouve être null.

Un chemin vide sélectionne le document entier. Une seule barre oblique sélectionne une propriété dont le nom est une chaîne vide, si elle existe. Dans un nom de propriété, / est encodé sous la forme ~1 et ~ sous la forme ~0. Par exemple, /a~1b sélectionne la propriété a/b. La séquence ~01 représente le texte ~1, et non une barre oblique. Les espaces du chemin ne sont pas supprimés, car ils peuvent faire partie du nom. Les noms doivent correspondre exactement : la casse, les accents et les différentes formes de normalisation Unicode sont distingués.

Les index de tableau commencent à zéro et doivent être écrits comme des entiers non négatifs sans zéros. /items/01 ne sélectionne pas le deuxième élément. Un trait d'union n'est pas interprété comme le dernier élément non plus ; cette recherche ne récupère que les valeurs qui existent déjà. Un nom tel que constructeur n'est accessible que lorsqu'il est un membre propre de l'objet JSON, plutôt que quelque chose hérité de la chaîne de prototype de JavaScript. L'interface accepte la forme textuelle de JSON Pointer, non JSONPath expressions avec des caractères génériques, des filtres ou des signes dollar, et non la représentation URI-fragment d'un pointeur.

La sortie conserve le type JSON de la valeur sélectionnée. Les chaînes apparaissent entre guillemets, les nombres restent des nombres, null reste null et les objets ou tableaux sont affichés en retrait JSON. Cela rend les fragments téléchargés interprétables par un autre programme. L'analyse rejette les clés en double pour empêcher la sélection de membres ambiguës et les entiers en dehors de la plage de sécurité du navigateur pour empêcher la perte de précision. Les identifiants numériques longs doivent être fournis sous forme de chaînes par le système d'origine. L'entrée prend en charge un million de caractères, une centaine de niveaux d'imbrication et un nombre limité d'éléments pour garder la page réactive. Pour les documents plus volumineux, réduisez d'abord le contenu tout en conservant la structure nécessaire au chemin sélectionné et vérifiez la valeur extraite par rapport à la source d'origine.