Testeur JSONPath gratuit — Évaluez en ligne

Qu'est-ce qu'un testeur JSONPath ?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

Fonctionnalités clés

Exemples concrets

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

Comment utiliser le testeur JSONPath

1. 1

   Collez ou téléversez votre JSON

   Déposez le JSON dans le champ de saisie, collez-le, ou cliquez sur Téléverser pour charger un fichier .json / .txt depuis le disque. Formater le JSON réindente le document. Un JSON invalide est signalé en ligne avec un message de l'analyseur avant la requête.

2. 2

   Choisissez un moteur

   RFC 9535 (le standard IETF de 2024, sans eval) est le moteur par défaut. Passez à Classique (Goessner) lorsque vous exécutez une expression copiée d'un ancien outil tel que jsonpath.com pour que les résultats correspondent à ce que vous y avez vu.

3. 3

   Saisissez votre expression JSONPath

   Le $ initial est affiché pour vous. Commencez par un chemin enfant comme .store.book[*].title, un indice comme [0], une descente récursive comme ..author, ou un filtre comme [?(@.price < 10)]. Les résultats se mettent à jour en direct au fur et à mesure de la saisie.

4. 4

   Changez la vue des résultats

   Valeurs affiche un tableau JSON des valeurs correspondantes. Chemins affiche le chemin normalisé de chaque correspondance tel que $['store']['book'][0]['title']. Les deux les affiche côte à côte pour que vous reliiez chaque valeur à son emplacement exact dans le document.

5. 5

   Copiez le résultat ou partagez un lien permanent

   Copier le résultat place la sortie dans votre presse-papiers. Copier le lien encode le JSON, l'expression, le moteur et la vue dans un fragment d'URL (sans téléversement) pour qu'un collègue reproduise la requête exacte localement sur sa propre machine.

Erreurs JSONPath courantes

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

Qui utilise cet outil

Extraire des champs d'une réponse d'API

Extrayez des identifiants de requête, des attributs de ressource imbriqués ou une liste de noms d'une charge utile JSON sans écrire de code de parcours. Construisez le chemin ici sur un exemple de réponse, confirmez qu'il renvoie exactement les nœuds voulus dans la vue Valeurs, puis collez l'expression validée dans votre application ou votre test.

Écrire des assertions pour les tests d'intégration

De nombreux frameworks de test et outils de tests contractuels (REST Assured, Karate, Postman) utilisent JSONPath pour valider les corps de réponse. Rédigez le chemin d'assertion ici, vérifiez qu'il sélectionne le bon nœud sur une réponse réelle, et copiez-le dans votre test — en détectant un mauvais chemin avant que la suite ne passe au rouge.

Configurer des transformations de données dans les pipelines

Kubernetes, AWS Step Functions, Azure Logic Apps et de nombreux outils ETL acceptent JSONPath pour adresser des champs dans les charges utiles d'événements. Prototypez le chemin exact ici sur un événement représentatif, confirmez qu'il se résout, et déposez-le dans la configuration de votre pipeline avec la certitude qu'il pointe là où vous le souhaitez.

Reproduire un résultat de jsonpath.com en privé

Vous avez une expression issue d'un évaluateur côté serveur mais vous ne pouvez pas coller vos données sur un site tiers ? Passez en mode Classique (Goessner), chargez votre JSON, et reproduisez le même résultat localement — aucune charge utile ne quitte jamais votre navigateur, donc les données propriétaires restent sur votre machine.

Migrer des expressions héritées vers RFC 9535

Vous migrez vers un système annonçant la conformité à RFC 9535 ? Exécutez une expression héritée en mode Classique, puis basculez sur le moteur RFC 9535 pour voir si elle s'analyse encore et correspond aux mêmes nœuds. La comparaison double moteur cible les différences de filtre, d'union et de fonction que vous rencontreriez sinon en production.

Déboguer pourquoi un chemin renvoie les mauvais nœuds

Un chemin qui sélectionne trop ou trop peu est difficile à raisonner à partir des seules valeurs. Passez à la vue Chemins pour voir l'emplacement normalisé de chaque correspondance — l'indice de tableau exact, la chaîne de membres exacte — et l'erreur d'écart d'un dans une tranche ou la descente récursive parasite devient immédiatement évidente.

Enseigner ou réviser JSONPath

Ouvrez une expression fonctionnelle sur des données d'exemple et parcourez-la sélecteur par sélecteur, en basculant entre Valeurs et Chemins pour que l'apprenant voie à la fois ce qui est sélectionné et où cela se trouve. L'aide-mémoire et les exemples concrets fournissent une référence structurée pour la revue de code ou l'intégration.

Notes sur le moteur et l'algorithme

Moteur RFC 9535 (jsonpath-rfc9535, sans dépendance)

Le moteur par défaut implémente directement la grammaire IETF RFC 9535 : il tokenise et analyse l'expression en un arbre syntaxique abstrait et l'interprète sur le document. Il n'y a ni eval ni constructeur Function nulle part dans le chemin, il est donc immunisé contre la classe de bugs d'injection eval et fonctionne sous une Content-Security-Policy stricte.

Moteur Classique (jsonpath-plus, eval désactivé)

Le moteur Classique (Goessner) est jsonpath-plus, épinglé à une version corrigée (>= 10.4.0) et configuré avec l'option eval explicitement à false. Cela conserve la compatibilité avec le dialecte Goessner tout en fermant les vecteurs d'exécution de code à distance suivis sous CVE-2024-21534 et CVE-2025-1302, qui affectaient le chemin de filtre eval par défaut de la bibliothèque.

Génération de chemins normalisés

Chaque correspondance est rapportée avec son chemin normalisé RFC 9535 — une forme canonique utilisant la notation entre crochets et guillemets simples ($['store']['book'][0]['title']) avec les indices de tableau en entiers nus. Les chemins normalisés sont stables et uniques par nœud, donc des expressions équivalentes produisent des chemins identiques, ce sur quoi reposent les vues Chemins et Les deux pour une identification non ambiguë des résultats.

Fragments de moteur chargés à la demande

Les deux moteurs sont chargés sous forme de fragments JavaScript distincts uniquement à la première sélection, de sorte que la page initiale reste légère et que le moteur que vous n'utilisez pas n'est jamais téléchargé. Changer de moteur réévalue immédiatement l'expression courante sur le document courant, sans rechargement de page.

Lecture de fichier locale et formatage JSON

Le bouton Téléverser utilise l'API FileReader du navigateur pour lire un fichier .json ou .txt dans la saisie entièrement côté client — le fichier n'est jamais transmis. Formater le JSON analyse et resérialise l'entrée avec une indentation de deux espaces, en faisant remonter les erreurs d'analyse en ligne pour qu'un JSON malformé soit détecté avant l'évaluation.

Liens permanents via fragment d'URL (jamais transmis)

L'état de partage est encodé dans le fragment location.hash, transportant le JSON, l'expression, le moteur actif et la vue des résultats. Les navigateurs n'incluent jamais le fragment dans les requêtes HTTP, donc les serveurs de go-tools.org ne reçoivent aucune donnée à l'ouverture d'un lien permanent ; le rechargement se fait entièrement sur l'appareil du destinataire.

Bonnes pratiques JSONPath

Choisissez le moteur qui correspond à votre cible

Si votre système en aval annonce la conformité à RFC 9535, écrivez et validez avec le moteur RFC 9535. Si vous reproduisez ou maintenez une expression d'un ancien outil ou d'une ancienne bibliothèque, utilisez Classique (Goessner). Valider avec le mauvais dialecte est la raison la plus fréquente pour laquelle un chemin qui fonctionnait dans le testeur échoue en production.

Vérifiez avec la vue Chemins, pas seulement les Valeurs

La vue Valeurs vous dit ce qui a correspondu ; la vue Chemins vous dit où. Quand une requête renvoie des valeurs qui semblent correctes, elle peut tout de même les sélectionner depuis le mauvais emplacement — une descente récursive parasite ou un joker trop large. Vérifiez les chemins normalisés pour confirmer que l'expression atteint exactement les nœuds voulus.

Attention à la fin exclusive d'une tranche

[0:2] sélectionne les indices 0 et 1, pas 0 à 2 — la borne de fin est exclusive, tout comme en Python et JavaScript. Les erreurs d'écart d'un sur les tranches sont le bug JSONPath le plus fréquent. Utilisez la vue Chemins pour lire l'indice exact de chaque élément sélectionné et confirmer la limite avant de livrer.

Préférez un chemin explicite à la descente récursive quand vous le pouvez

$..price est pratique mais correspond à chaque prix où qu'il soit dans le document, y compris ceux que vous ne visiez pas. Quand vous connaissez la structure, écrivez le chemin complet ($.store.book[*].price) pour que la requête reste précise et prévisible à mesure que les données grandissent. Réservez .. aux formes réellement irrégulières ou inconnues.

Gardez espaces et guillemets cohérents dans les filtres

RFC 9535 suit sa grammaire à la lettre pour les expressions de filtre, tandis que le dialecte classique est plus souple. Écrivez les filtres proprement — entourez les littéraux de chaîne de guillemets simples ('fiction'), espacez les opérateurs, et évitez de compter sur une analyse permissive — pour que la même expression s'évalue de la même façon quel que soit le moteur ou la bibliothèque qui finira par l'exécuter.

Foire aux questions