JSONPath tester en ligne
Exécutez un chemin, voyez chaque résultat
De plus, ce JSONPath tester en ligne exécute votre chemin sur votre JSON et liste chaque résultat avec son adresse exacte. Filtres, tranches et jokers fonctionnent, dans votre propre onglet.
- GratuitPrix
- 8Sélecteurs
- AucuneInscription
- AucuneEnvois
JSONPath tester
Tapez un chemin, voyez chaque résultat et son chemin exact
Collez du JSON à gauche pour commencer.
La syntaxe JSONPath en un coup d'œil
$ | La racine du document. |
|---|---|
@ | L'élément courant, dans un filtre. |
.name ["name"] | Un enfant, par nom. |
[*] .* | Chaque enfant. |
.. | Cherche à toute profondeur en dessous. |
[0] [-1] | Un élément de liste, compté depuis le début ou depuis la fin. |
[0,2] | Plusieurs éléments à la fois. |
[1:3] [::2] | Une tranche : de, jusqu'à exclu, et un pas. |
[?(@.price < 10)] | Un filtre : garde les enfants pour lesquels le test est vrai. |
&& || ! | Et, ou et non, dans un filtre. |
=~ /^a/i | Compare du texte à une expression régulière. |
length() count() | Fonctions : length, count, match, search et value. |
Prêt. Collez du JSON, tapez un chemin et les résultats apparaissent.
À quoi sert un JSONPath tester en ligne
JSONPath est un petit langage pour extraire des valeurs d'un JSON. Par ailleurs, pensez à XPath pour JSON. Une courte ligne peut tirer chaque prix d'une énorme réponse.
Ce JSONPath tester en ligne vous laisse essayer un chemin avant de le mettre dans le code. D’ailleurs, collez votre JSON, tapez le chemin, et les résultats apparaissent pendant que vous tapez. Chaque résultat montre aussi son chemin complet.
Cela aide à bien des endroits. Ainsi, les outils d'API, les suites de tests, la recherche de journaux et les applis sans code acceptent JSONPath. Un mauvais chemin ne renvoie rien, et rien ressemble à un succès. Tester d'abord fait donc gagner du temps.
Le moteur est construit de zéro, et il n'exécute jamais votre texte comme du code. Il suit la forme de la RFC 9535, et il accepte aussi l'ancien style que beaucoup connaissent.
En effet, JSONPath aide aussi au débogage. Imaginez qu'un test échoue parce qu'un champ manque. Collez la réponse, exécutez un chemin et voyez en quelques secondes si le champ existe, et où. De plus, alors vous pouvez réparer le test en confiance.
Votre premier chemin
Tout chemin commence par un signe dollar. Il représente la racine du document. Ensuite, vous ajoutez des étapes. Par ailleurs, un point et un nom choisissent un enfant. Ainsi $.store.bicycle.color descend jusqu'à la couleur du vélo.
Les crochets font le même travail et admettent aussi des noms avec des espaces ou des points. Écrivez $["my key"] pour ceux-là. Les nombres entre crochets choisissent un élément de liste, en partant de zéro.
Cliquez sur Essayer un exemple puis sur une puce d'exemple. D’ailleurs, l'outil remplit le chemin et l'exécute aussitôt.
Jokers et recherche partout
Une étoile signifie chaque enfant. $.store.book[*].author donne l'auteur de chaque livre. La même étoile marche après un point, comme dans $.store.*.
Deux points signifient chercher à toute profondeur. $..price trouve chaque prix de tout le document, qu'il soit dans un livre ou sur un vélo. Ainsi, c'est le moyen le plus rapide de trouver une valeur quand vous ne savez pas où elle se cache.
Les résultats reviennent dans l'ordre du document. Chacun montre le chemin exact où il vit, donc vous pouvez le copier et l'utiliser comme adresse précise.
Rappelez-vous aussi que les résultats gardent leur ordre. Si une liste contient dix éléments, les résultats reviennent dans le même ordre. Vous pouvez donc les apparier sans risque avec une autre liste.
Tranches, unions et indices négatifs
En effet, vous pouvez choisir plusieurs éléments à la fois. [0,2] prend le premier et le troisième. [1:3] est une tranche. Elle prend les éléments de l'indice 1 jusqu'à l'indice 3 exclu.
Les tranches acceptent un pas. [::2] prend un élément sur deux. Les nombres négatifs comptent depuis la fin, donc [-1] est le dernier élément et [-2:] les deux derniers.
JSONPath filter en ligne
De plus, les filtres sont la partie la plus puissante. Ils ne gardent que les enfants qui réussissent un test. $.store.book[?(@.price < 10)] garde les livres moins chers que dix. L'arobase représente l'élément testé.
Par ailleurs, combinez les tests avec et, ou et non. Testez qu'une clé existe en l'écrivant seule, comme [?(@.isbn)]. Comparez des nombres, du texte, true, false et null.
Besoin de faire correspondre du texte ? Utilisez une expression régulière avec =~, comme dans [?(@.author =~ /^e/i)]. Ou appelez une fonction comme length(@.title) ou count(@.*).
Des messages clairs quand un chemin est faux
D’ailleurs, une faute de frappe ne doit pas vous laisser deviner. Quand le chemin est invalide, l'outil dit ce qui ne va pas et place un signe sous l'endroit exact. Un crochet manquant, une mauvaise expression régulière et une fonction inconnue reçoivent chacun leur propre phrase.
Trois façons d'écrire un chemin
Ainsi, chaque résultat montre son adresse. Passez Afficher les chemins en sur crochets, points ou JavaScript. La forme JavaScript, comme data.store.book[0].title, se glisse directement dans votre code.
Sur cette page
- L’outil
- À quoi sert un JSONPath tester en ligne
- Utiliser le JSONPath tester, pas à pas
- Ce que ce JSONPath tester fait autrement
- Habitudes pour écrire des chemins fiables
- Erreurs JSONPath courantes que ce testeur repère
- Questions fréquentes sur le JSONPath tester
- Des compagnons utiles pour travailler avec JSON
Continuer
Utiliser le JSONPath tester, pas à pas
Quatre étapes vous mènent du JSON brut à un chemin de confiance.
- 1
Collez votre JSON
Collez-le, ouvrez un fichier ou chargez l'exemple de la librairie. L'outil le vérifie pendant que vous tapez.
- 2
Tapez un chemin
Commencez par un signe dollar. Cliquez sur une puce d'exemple si vous voulez un coup de pouce.
- 3
Lisez les résultats
Chaque résultat montre sa valeur et son propre chemin. Le compteur dit combien il y en a.
- 4
Copiez ce qu'il vous faut
Copiez les valeurs en liste JSON, ou les chemins, un par ligne.
Ce que ce JSONPath tester fait autrement
Beaucoup de testeurs renvoient une valeur et s'arrêtent. Voici les extras.
Chaque résultat montre son chemin
Vous voyez l'adresse exacte de chaque résultat, en crochets, points ou JavaScript. Copiez n'importe lequel.
De vrais filtres
Utilisez et, ou, non, comparaisons, expressions régulières et fonctions dans un filtre.
Des erreurs utiles
Un signe pointe l'erreur, et une phrase claire dit quoi changer.
Nombres exacts
Les longs identifiants gardent chaque chiffre, donc un résultat n'affiche jamais un nombre arrondi.
Aide-mémoire intégré
Un court tableau de la syntaxe se trouve sous l'outil, donc vous ne quittez jamais la page.
Rien ne quitte votre onglet
Les vraies données d'API contiennent souvent des détails privés. Comme votre navigateur fait le travail, rien n'arrive sur ce site.
Habitudes pour écrire des chemins fiables
Un chemin qui marche sur un échantillon peut échouer sur le suivant. Ces habitudes aident.
- Commencez par le chemin le plus court. Ajoutez une étape à la fois. Quand un chemin casse, vous savez quelle étape l'a fait.
- Utilisez les deux points avec parcimonie. Chercher à toute profondeur est pratique. Mais cela peut capter des champs que vous ne vouliez pas choisir. Préférez un chemin clair quand vous le connaissez.
- Testez avec de vraies données. Collez une vraie réponse, pas un exemple bien rangé. Les vraies données ont des clés manquantes et des valeurs bizarres.
- Vérifiez le cas vide. Demandez ce que renvoie le chemin quand rien ne correspond. Votre code doit gérer une liste vide.
- Testez qu'une clé existe avant de la comparer. Un filtre sur une clé absente écarte simplement l'élément. Ajoutez un test d'existence si vous devez savoir pourquoi.
- Mettez entre guillemets les noms à caractères spéciaux. Un nom avec un point ou une espace exige des crochets et des guillemets, comme
["my key"]. - Surveillez le type dans une comparaison. Le nombre 5 et le texte "5" sont différents. Un filtre qui les compare répond non.
- Connaissez votre bibliothèque. Des bibliothèques différentes prennent en charge une syntaxe un peu différente. Testez ici, puis vérifiez votre bibliothèque pour les cas limites.
- Utilisez le chemin exact pour les mises à jour. Pour changer une valeur, utilisez le chemin complet de la liste, pas une recherche. Vous évitez ainsi de toucher la mauvaise.
- Gardez vos meilleurs chemins. Tenez une courte liste dans vos notes. Un bon chemin mérite d'être réutilisé.
Erreurs JSONPath courantes que ce testeur repère
Chacune ne renvoie rien ou renvoie autre chose. En effet, le testeur le montre aussitôt.
Oublier le signe dollar
Un chemin doit commencer par $. Le testeur vous le dit, au lieu de renvoyer une liste vide.
Un crochet manquant
De plus, un crochet ouvert sans fermeture casse tout le chemin. Le signe montre où il s'arrête.
Compter à partir de un
Les listes commencent à zéro. Ainsi
[1]est le deuxième élément, pas le premier.Comparer avec le mauvais type
Par ailleurs, un prix stocké en texte ne réussit pas un test numérique. Vérifiez la valeur dans les résultats.
Utiliser des crochets de script
L'ancienne syntaxe comme
[(@.length-1)]exécute du code. Cet outil la refuse par sécurité. D’ailleurs, utilisez plutôt un indice négatif.Trop capter avec deux points
Une recherche profonde peut ramasser des clés semblables ailleurs. Lisez le chemin de chaque résultat.
Questions fréquentes sur le JSONPath tester
Ce JSONPath tester en ligne est-il gratuit ?
Oui. Il ne coûte rien, n'exige aucun compte et n'a aucune limite. Comme il tourne dans votre navigateur, nous n'avons aucun coût de serveur à vous répercuter.
Mon JSON est-il envoyé quelque part ?
Non. Par ailleurs, votre navigateur exécute le chemin. Rien n'arrive sur ce site et nous ne gardons rien. De plus, fermer l'onglet efface tout.
Qu'est-ce que JSONPath ?
C'est un langage de requête pour JSON. D’ailleurs, une courte expression sélectionne des valeurs par nom, position ou condition, comme XPath le fait pour XML.
Suit-il la RFC 9535 ?
Il suit la forme de la norme, avec filtres, tranches et fonctions. Il accepte aussi l'ancien style de Goessner que beaucoup de bibliothèques utilisent encore.
Que signifient deux points ?
Ils signifient chercher à toute profondeur. <code>$..name</code> trouve chaque clé name, aussi profonde soit-elle.
Comment filtrer par une valeur ?
Utilisez un filtre entre crochets. Par exemple, <code>[?(@.price > 10)]</code> garde les éléments dont le prix dépasse dix. L'arobase représente l'élément.
Puis-je utiliser une expression régulière ?
Oui. Écrivez <code>=~</code> et un motif entre barres obliques, comme <code>[?(@.name =~ /^a/i)]</code>. L'indicateur i ignore la casse.
Pourquoi dit-il que les expressions de script ne sont pas prises en charge ?
Ainsi, l'ancienne syntaxe avec des parenthèses dans des crochets évalue du code. Nous la refusons pour que rien ne puisse s'exécuter. Un filtre ou un indice négatif fait la même chose.
Pourquoi mon chemin ne renvoie-t-il rien ?
Vérifiez les noms, la casse et les crochets. Vérifiez aussi le type dans un filtre. Partez de <code>$</code> et ajoutez une étape à la fois.
Puis-je utiliser le chemin dans mon code ?
Oui. En effet, la plupart des bibliothèques acceptent la même syntaxe. Testez ici, puis collez le chemin dans votre code. Si une bibliothèque diffère, l'aide-mémoire montre quoi ajuster.
Que se passe-t-il avec des clés en double ?
La première l'emporte quand vous choisissez par nom. Une recherche profonde peut quand même atteindre les deux, car elle visite chaque entrée.
Les grands nombres sont-ils affichés exactement ?
Oui. Le lecteur garde chaque chiffre, donc un identifiant de 20 chiffres apparaît comme vous l'avez écrit.
Fonctionne-t-il sur un téléphone ?
Oui. Les deux panneaux s'empilent et les puces d'exemple passent à la ligne. Pour une longue modification, un clavier reste pourtant plus confortable.
Des compagnons utiles pour travailler avec JSON
Ainsi, tester un chemin est une étape. Ces trois outils s'occupent des étapes autour.
Visionneuse JSON
Lisez du JSON en arbre ou en table, puis modifiez-le.
Ouvrir l’outil →Formateur JSON
Embellissez, minifiez et validez avec la ligne exacte de chaque erreur.
Ouvrir l’outil →Comparer JSON
En effet, comparez deux documents JSON par le sens et listez chaque changement.
Ouvrir l’outil →
Prêt à tester un chemin ?
Collez votre JSON, tapez un chemin JSONPath et lisez les résultats. De plus, le testeur est gratuit, n'exige aucun compte et garde chaque octet sur votre appareil.