Contrôler un champ de réponse API
Visez précisément une valeur telle que $.user.id avant de rédiger une extraction dans votre application. L’outil ne contacte pas le serveur et ne vérifie pas la fraîcheur de la réponse copiée.
Testeur JSONPath
Interrogez des données JSON avec une expression JSONPath simple. Le traitement est effectué directement dans votre navigateur.
- Presse-papiers
- Export
Données non envoyées
Expression
JSON invalide ou chemin non pris en charge. Utilisez un nom de propriété, une clé entre guillemets ou un indice entier positif ; filtres, jokers et parcours récursifs ne sont pas pris en charge.
Résultat
Cet outil vous a-t-il été utile ?
Comment fonctionne cet outil ?
Ce testeur sélectionne une valeur dans un document JSON à partir d’un chemin simple. Il est utile pour retrouver un champ imbriqué, vérifier un indice de tableau ou comprendre pourquoi une propriété attendue manque dans une réponse API. Le résultat est affiché comme JSON : un objet garde sa structure, une chaîne reste entre guillemets et null reste distinct d’une absence de correspondance. L’évaluation se fait dans votre navigateur, sans interroger l’URL d’une API ni transmettre le document à un serveur de requêtes.
Le chemin commence de préférence par $, qui représente le document entier. Une propriété ordinaire se sélectionne avec un point, par exemple $.user.name. Un indice entre crochets sélectionne un élément de tableau ; les indices commencent à zéro. Seuls les indices entiers non négatifs sont acceptés : un tableau à trois éléments possède les positions 0, 1 et 2.
Les clés contenant des espaces, points ou tirets doivent être écrites entre guillemets dans des crochets. Ainsi $["a.b"] vise la propriété littéralement nommée a.b, tandis que $.a.b vise b à l’intérieur de a. Les guillemets simples et doubles sont acceptés pour cette notation. Les caractères spéciaux doivent respecter les séquences d’échappement reconnues par le sélecteur.
Il s’agit d’un sous-ensemble de navigation, pas d’une implémentation complète de RFC 9535. Filtres, jokers, tranches de tableaux, indices négatifs et descente récursive sont refusés avec un message explicite. Une expression telle que $..name doit être simplifiée en chemin exact ; elle n’est pas exécutée comme une recherche globale. Une expression valide sélectionne au plus une valeur, et non une liste normalisée de nœuds.
Le document est analysé avec les types JSON du navigateur. Les nombres dépassant la précision de JavaScript peuvent donc être arrondis lors de la lecture et de la réécriture du résultat. Transmettez les grands identifiants sous forme de chaînes. Seules les propriétés propres du document sont consultées : un nom hérité comme constructor ne devient jamais une correspondance artificielle.
Comment utiliser cet outil ?
Fournir un document JSON valide
Collez le corps JSON complet, sans en-têtes HTTP ni clôtures Markdown. Un tableau à la racine est accepté et se parcourt directement avec $[0].
Construire un chemin exact
Partez de $, ajoutez les propriétés une à une et utilisez des crochets pour les indices ou clés particulières. Les filtres d’un autre moteur ne sont pas compatibles ici.
Interpréter la sélection
Exécutez le chemin, puis vérifiez le type et la valeur obtenus. Modifier le texte ou l’expression masque l’ancien résultat afin d’éviter de réutiliser une sélection périmée.
Cas d'utilisation
Lire un tableau sans confondre ses positions
Testez la première entrée avec [0], puis une autre position connue. Un indice hors limites renvoie une absence ; il ne crée pas d’élément de remplacement.
Diagnostiquer une clé contenant un point
Comparez notation pointée et clé entre guillemets pour distinguer une structure imbriquée d’un nom de propriété contenant réellement un séparateur.
Exemples
Sélectionner une clé avec point puis une clé avec espace
Le premier crochet vise a.b comme nom complet, [0] sélectionne le premier objet et le dernier crochet vise quoted key. La sortie est une chaîne JSON valide, guillemets compris.
Entrée
{"a.b":[{"quoted key":"Ada"}]}
$["a.b"][0]['quoted key']Résultat
"Ada"Ne pas sélectionner une propriété héritée
Le document vide ne contient pas constructor comme propriété propre. Le testeur affiche son marqueur d’absence, même si les objets JavaScript possèdent habituellement ce nom dans leur prototype.
Entrée
{}
$.constructorRésultat
[]Conseils et bonnes pratiques
- Commencez par $ pour vérifier le document entier, puis ajoutez un segment ; cela permet d’identifier précisément l’étape où la sélection disparaît.
- Une sortie [] peut signifier absence de correspondance ou tableau vide réellement sélectionné. Vérifiez le parent si cette distinction compte dans votre traitement.
- null est une valeur présente, tandis qu’un chemin manquant ne sélectionne rien. Ne les fusionnez pas dans une règle de validation.
- Utilisez XPath pour interroger du XML. Changer l’extension du fichier ne transforme pas un document XML en structure JSON.
Sources et références
- RFC 9535 — JSONPath: Query Expressions for JSON (s’ouvre dans un nouvel onglet), RFC EditorPage en anglais
Questions fréquentes
Pourquoi mon filtre ou mon joker JSONPath est-il refusé ?
Le testeur ne met en œuvre que des chemins exacts avec propriétés et indices. Il refuse les syntaxes non prises en charge plutôt que de donner un résultat incomplet présenté comme conforme à toute la norme.
Comment viser une propriété dont le nom contient un point ?
Écrivez le nom complet entre guillemets dans des crochets, par exemple $["a.b"]. La notation $.a.b désigne deux niveaux d’objet différents et ne sélectionne pas cette même clé.
Les indices de tableau commencent-ils à un ou à zéro ?
À zéro. [0] désigne le premier élément, [1] le deuxième. Les indices négatifs, décimaux et tranches ne sont pas disponibles ; une position inexistante produit le marqueur d’absence [].
Pourquoi le résultat d’une chaîne contient-il des guillemets ?
La sortie conserve le type JSON sélectionné : "Ada" est une chaîne, alors que Ada seul n’est pas un document JSON valide. Les objets et tableaux sont sérialisés avec indentation pour faciliter leur lecture.
Outils associés
Continuez avec ces outils
Des outils similaires ou complémentaires à celui-ci.
Outils similaires
Formatez, minifiez et validez un document JSON pour le rendre plus lisible ou plus compact.
DéveloppementMis en avantUtiliser l’outil
Validez un document JSON avec un schéma et localisez précisément chaque erreur.
DéveloppementMis en avantUtiliser l’outil
Testez une expression XPath sur un document XML et inspectez immédiatement les résultats correspondants.
DéveloppementUtiliser l’outil