Formateur et validateur GraphQL

Collez une requête, une mutation ou un schéma pour le mettre en forme, le minifier ou repérer ce qui ne va pas. Ajoutez votre schéma et chaque champ, argument et variable de la requête sera vérifié par rapport à lui.

Mis à jour le
Valider avec un schéma — SDL facultatif, vérifie les champs, arguments, types et variables

Vos données ne quittent jamais votre ordinateur. Tout le traitement se fait localement dans votre navigateur.

Comment utiliser : Formateur et validateur GraphQL

  1. Collez une requête, une mutation, une souscription, un fragment ou un schéma (SDL).
  2. La mise en forme se fait pendant la saisie ; les erreurs de syntaxe indiquent la ligne et la colonne.
  3. Vous pouvez ouvrir Valider avec un schéma et coller votre SDL pour vérifier chaque champ et argument.
  4. Copiez le résultat formaté ou minifié.

Ce que contrôle le validateur

Sans schéma, l’outil vérifie la syntaxe : accolades équilibrées, noms valides, syntaxe des arguments et variables, échappements des chaînes et des chaînes de blocs. Avec un schéma, il applique l’ensemble complet des règles de validation GraphQL définies par la spécification, les mêmes que celles qu’un serveur GraphQL applique avant d’exécuter une requête :

  • Chaque champ existe sur son type, et les champs feuilles (scalaires, énumérations) n’ont pas de sous-sélection alors que les champs objets en ont une.
  • Les arguments existent, les arguments obligatoires sont fournis et les valeurs ont le bon type.
  • Les variables sont déclarées, utilisées, et leurs types correspondent à leurs emplacements d’utilisation.
  • Les fragments sont utilisés, correspondent au type sur lequel ils sont appliqués et ne forment pas de cycles.
  • Les noms d’opérations sont uniques et les opérations anonymes sont seules.

Mise en forme et minification

La mise en forme utilise la fonction de référence print de graphql-js, ce qui fait que le résultat correspond à celui de la plupart des outils GraphQL : indentation de deux espaces, un champ par ligne et espacement normalisé des arguments. La minification supprime les commentaires et les espaces inutiles, ce qui est utile pour les requêtes GET et les requêtes persistées où chaque octet compte. Besoin de construire une requête à partir d’un schéma ? Utilisez le constructeur de requêtes GraphQL.

Aussi recherché comme : formateur graphql, validateur graphql, formater requête graphql, vérifier syntaxe graphql, minifier graphql, valider schéma graphql, graphql prettify, formateur sdl.

Outils complémentaires : Formateur et validateur GraphQL

  • Formateur JSON — Collez votre code JSON pour le formater, le compresser ou le valider.
  • Validateur OpenAPI / Swagger — Collez une spécification d'API pour la vérifier par rapport au schéma OpenAPI officiel, repérer les références cassées et les paramètres de chemin incohérents, et voir tous vos endpoints d'un coup d'œil.
  • Validateur JSON Schema — Collez un schéma et du JSON pour voir précisément quelles valeurs enfreignent quelle règle, ou générez un schéma de départ à partir de données d'exemple.
  • Testeur de webhook — Obtenez une URL unique, envoyez-y n’importe quel webhook ou client HTTP et observez les requêtes en temps réel : en-têtes, chaîne de requête et corps mis en forme, ainsi que la vérification des signatures HMAC.

Questions fréquentes

Prend-il en charge les fichiers de schéma (SDL) ?
Oui. Les définitions de types, interfaces, unions, énumérations, types d’entrée, directives et extensions de schéma sont mis en forme et vérifiés syntaxiquement comme les requêtes.
Peut-il récupérer mon schéma depuis un endpoint ?
Non, collez plutôt le SDL. Vous pouvez l’exporter avec des outils comme rover graph introspect, get-graphql-schema ou depuis le code de votre serveur.
Ma requête est-elle envoyée quelque part ?
Non. L’analyse, la mise en forme et la validation s’exécutent dans votre navigateur avec graphql-js.
Puis-je installer Formateur et validateur GraphQL en tant qu’application web et l’utiliser hors ligne ?
Oui. Formateur et validateur GraphQL est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.

Outils similaires