Présentation du Testeur JSONPath
Le Testeur JSONPath est un outil conçu pour évaluer et tester des expressions JSONPath directement sur vos données JSON. En saisissant vos données JSON et votre expression JSONPath dans l'outil, vous visualisez immédiatement les valeurs correspondantes ainsi que leurs chemins d'accès exacts au sein du document JSON d'origine. Ce processus interactif vous permet de comprendre précisément quelles données votre expression JSONPath va extraire.
Cet outil s'adresse particulièrement aux profils suivants:
- Les développeurs d'API.
- Les testeurs.
- Les ingénieurs de données.
- Le personnel de support.
- Toute personne ayant besoin de comprendre ce qu'une expression JSONPath extrait d'un document JSON.
- Toute personne souhaitant copier une valeur spécifique depuis un JSON tout en conservant son emplacement d'origine.
Fonctionnement et limites de saisie
L'outil repose sur deux champs de saisie principaux:
- Entrée JSON: Une zone de texte dans laquelle vous collez vos données JSON. La taille maximale autorisée pour cette entrée est de 500 000 caractères.
- Expression JSONPath: Un champ de texte dans lequel vous saisissez ou collez votre expression JSONPath. La longueur maximale autorisée pour cette saisie est de 4 000 caractères.
Si vos saisies dépassent ces limites, l'outil applique des règles strictes et affiche des messages d'erreur spécifiques:
- Si le JSON saisi dépasse 500 000 caractères, le message suivant s'affiche: « Ce JSON est trop volumineux pour être testé ici. Utilisez un exemple plus petit. ».
- Si l'expression JSONPath dépasse 4 000 caractères, le message suivant s'affiche: « Cette expression JSONPath n’est pas valide. » ou plus précisément « Cette expression JSONPath est trop longue pour être testée ici. ».
Résultats et affichage des correspondances
Une fois l'évaluation effectuée, l'outil génère plusieurs éléments de sortie:
- Valeurs trouvées: La liste des valeurs qui correspondent à l'expression JSONPath saisie.
- Correspondances:
{count}: Le nombre total de correspondances trouvées. - Affichage des
{max}premières: Une note indiquant qu'un nombre limité de correspondances est affiché. L'outil affiche un maximum de 200 résultats. Si le nombre de correspondances dépasse 200, l'outil affiche « Correspondances: 200+ » et la mention « Affichage des{max}premières ». - Détail: Un titre pour la vue détaillée de chaque correspondance. Chaque résultat inclut le chemin d'origine de la valeur dans le JSON source.
- Effacé.: Ce message s'affiche lorsque vous videz les champs de saisie.
Gestion des erreurs et limites de temps
Le testeur intègre un système de validation pour le JSON et pour l'expression JSONPath. En cas d'anomalie, des messages d'erreur précis sont renvoyés:
- Si le JSON saisi est malformé, l'outil affiche: « Ce JSON n’est pas valide. ».
- Si l'expression JSONPath est malformée, l'outil affiche: « Cette expression JSONPath n’est pas valide. ».
- Si l'expression JSONPath ne peut pas être évaluée, le message suivant apparaît: « Impossible d’évaluer ce JSONPath. ».
De plus, afin d'éviter les blocages, l'évaluation d'une expression JSONPath est interrompue si elle dépasse une courte limite de temps. Si la requête expire, l'outil affiche le message: « Ce JSONPath a pris trop de temps. Resserrez l’expression ou utilisez un exemple plus petit. ».
Syntaxes JSONPath prises en charge
Le Testeur JSONPath prend en charge les motifs et structures de requêtes les plus courants pour sélectionner des données au sein d'objets imbriqués ou de tableaux:
- Descente récursive: Permet de rechercher des éléments profondément imbriqués, par exemple avec le motif
$..price. - Filtres: Permet de sélectionner des données selon des critères précis, par exemple
[?@.price < 10]. - Tranches de tableau (slices): Permet de sélectionner des portions spécifiques de tableaux.
Confidentialité des données
La sécurité de vos données est préservée lors de l'utilisation de cet outil. Votre JSON et votre expression JSONPath sont testés directement dans votre navigateur. Aucune donnée n'est envoyée à BroBroGo.
FAQ
Quelle syntaxe JSONPath puis-je utiliser?
Vous pouvez utiliser les motifs courants comme $.store.book[*].title, la descente récursive avec $..price, les filtres comme [?@.price < 10] et les tranches de tableau.
Pourquoi chaque résultat affiche-t-il un chemin? Le chemin indique d'où vient la valeur dans le JSON source, ce qui vous permet de copier une correspondance sans perdre son emplacement d'origine.
Pourquoi une requête peut-elle expirer? Les requêtes récursives très larges ou les exemples de données énormes peuvent prendre trop de temps à s'exécuter. Le testeur interrompt l'évaluation après une courte limite de temps pour vous permettre de resserrer l’expression ou d'utiliser un exemple plus petit.