JSONPath : Requeter et Extraire des Donnees JSON

Qu est-ce que JSONPath ?

JSONPath est un langage de requete pour extraire des donnees depuis des structures JSON, de la meme facon que XPath extrait des donnees depuis du XML. Au lieu de parcourir manuellement un objet JSON imbrique, vous ecrivez une expression qui decrit le chemin vers les donnees souhaitees.

L expression $.store.books[0].title extrait le titre du premier livre dans un objet store. Le $ represente la racine du document, les points naviguent dans les objets, et les crochets accedent aux elements de tableaux. C est intuitif pour quiconque a travaille avec des objets JavaScript.

JSONPath est utile pour les reponses d API volumineuses ou vous n avez besoin que de quelques champs specifiques, pour les fichiers de configuration complexes ou vous cherchez une valeur particuliere, et pour les tests automatises qui verifient des valeurs dans des reponses JSON.

Syntaxe de Base

$ — La racine du document JSON.

$.propriete — Accede a une propriete de l objet racine.

$.tableau[0] — Accede au premier element d un tableau.

$.tableau[-1] — Accede au dernier element.

$.tableau[0:3] — Slice : les elements d index 0 a 2.

$.objet.* — Toutes les valeurs de l objet (wildcard).

$..propriete — Recherche recursive : trouve la propriete a n importe quel niveau d imbrication.

Filtres

Les filtres permettent de selectionner des elements selon des conditions. $.books[?(@.price < 10)] selectionne tous les livres dont le prix est inferieur a 10. Le @ represente l element courant dans le filtre.

Les operateurs de comparaison disponibles sont ==, !=, <, >, <=, >=. Les operateurs logiques && et || combinent des conditions. L operateur =~ teste une expression reguliere dans certaines implementations.

Exemples pratiques : $.users[?(@.active == true)] pour les utilisateurs actifs, $.products[?(@.stock > 0 && @.price < 50)] pour les produits en stock a moins de 50 euros.

Differences entre Implementations

JSONPath n a pas de specification formelle unique, ce qui entraine des differences entre les implementations. La RFC 9535 (publiee en 2024) standardise la syntaxe, mais les implementations existantes ne sont pas toutes conformes. Testez vos expressions avec l implementation que vous utiliserez en production.

Notre Outil JSONPath

Notre Outil JSONPath vous permet de tester des expressions JSONPath sur vos donnees. Collez votre JSON, ecrivez votre expression et voyez les resultats instantanement. Ideal pour le prototypage de requetes avant de les integrer dans votre code. Tout le traitement se fait dans le navigateur.