Comment extraire des valeurs JSON avec un chemin JSON

À quoi sert le testeur de chemin JSON ?

Cet outil sert à rechercher des valeurs dans un texte JSON à partir d’un chemin. Il convient notamment lorsqu’il faut vérifier la structure d’un objet, cibler une propriété ou parcourir des éléments de liste sans examiner manuellement tout le document. L’entrée JSON et le chemin sont fournis sous forme de texte. Les chemins pris en charge peuvent viser des propriétés séparées par des points, parcourir des valeurs ou des éléments avec un caractère générique, ou sélectionner des indices et des intervalles dans une liste. (Le chemin est une expression qui indique où chercher.)

Comment tester un chemin JSON

Préparez un JSON valide sous forme de texte. Placez-le dans le champ d’entrée JSON. Cette entrée est facultative, mais une entrée vide ou composée uniquement d’espaces aboutit à une réussite sans correspondance.
Saisissez le chemin à tester dans le champ prévu à cet effet. Il est lui aussi facultatif et, s’il est vide ou blanc, le traitement renvoie une réussite sans correspondance. Pour une propriété imbriquée, utilisez des noms séparés par des points. Pour parcourir des valeurs d’objet ou des éléments de liste, utilisez le caractère générique pris en charge. Pour une liste, vous pouvez aussi fournir un indice ou un intervalle entre crochets, selon la syntaxe acceptée.
Lancez l’extraction. Avec un JSON valide et un chemin qui se termine normalement, le résultat est considéré comme réussi, y compris lorsque le chemin ne correspond à aucune valeur. Si le JSON et le chemin contiennent tous deux du texte non blanc, un JSON invalide entraîne au contraire un résultat d’échec.
Examinez la réponse. Lorsqu’une extraction réussit sur une entrée et un chemin non vides, elle indique les valeurs trouvées, leur nombre et le chemin fourni. Conservez le JSON et le chemin utilisés si vous devez comparer plusieurs essais.

Comment lire le résultat et connaître les limites

Une réussite ne signifie pas forcément qu’une valeur a été trouvée. Si le document et le chemin sont valides mais qu’aucun élément ne correspond, la réponse reste réussie et le nombre de valeurs trouvées permet de distinguer ce cas d’une extraction qui a produit des résultats. Un échec peut notamment signaler que le texte JSON n’est pas valide lorsque le chemin contient lui aussi du texte non blanc.

Interprétez les résultats en fonction de la structure réellement fournie. Un chemin vers une propriété d’objet ne remplace pas un chemin visant une liste, et un indice ou un intervalle doit correspondre à la syntaxe acceptée. Les expressions mal formées ne suivent pas toutes le même comportement : certaines peuvent interrompre l’extraction sans produire la structure habituelle du résultat. La réponse ne doit donc pas être traitée comme une prise en charge de toutes les variantes de JSONPath.

Exemple pratique

Vous vérifiez dans un document JSON de catalogue si un chemin atteint bien les éléments d’une liste de produits.

Collez le document JSON contenant une liste de produits, puis testez un chemin qui cible cette liste ou un indice de la liste. Comparez ensuite le nombre de valeurs rapporté avec la partie du document visée.

Pour une extraction réussie avec une entrée et un chemin non vides, la réponse présente les valeurs trouvées, le nombre de valeurs et le chemin fourni. Si aucune valeur ne correspond, elle indique une réussite sans correspondance.

Limites

L’outil couvre le sous-ensemble de chemins décrit ici, et les expressions mal formées peuvent interrompre l’extraction sans résultat standard ; il ne faut pas l’assimiler à la prise en charge de toutes les expressions JSONPath.

Erreurs fréquentes

Erreur fréquente : coller un JSON invalide ou laisser l’entrée vide en attendant une valeur. Vérifiez la syntaxe du document avant l’extraction et confirmez que le JSON ainsi que le chemin contiennent le texte attendu ; une entrée vide est traitée avec succès, mais sans correspondance.

Questions fréquentes

Une recherche sans correspondance est-elle considérée comme réussie ?

Oui, si le chemin est valide et que l’extraction se termine normalement. Une recherche sans correspondance reste une réussite et indique zéro valeur trouvée. Un JSON invalide produit toutefois un échec lorsque l’entrée JSON et le chemin contiennent tous deux du texte non blanc.

Que se passe-t-il si je ne fournis pas de JSON ?

L’entrée JSON est facultative. Si elle est vide ou ne contient que des espaces, le traitement se termine avec une réussite et sans correspondance, au lieu d’extraire une valeur.

Quels chemins puis-je tester ?

Utilisez les formes prises en charge : propriétés séparées par des points, caractère générique pour parcourir des valeurs d’objet ou des éléments de liste, et expressions entre crochets pour des indices ou des intervalles de liste. La prise en charge ne couvre pas toutes les expressions JSONPath.

Que faire si le chemin semble mal formé ?

Un chemin mal formé ne produit pas nécessairement un échec présenté sous la structure habituelle. Les indices, intervalles entre crochets et autres formes invalides ne suivent pas tous un comportement uniforme ; corrigez donc le chemin avant de relancer l’extraction.