Comment utiliser : Formateur et validateur GraphQL
- Collez une requête, une mutation, une souscription, un fragment ou un schéma (SDL).
- La mise en forme se fait pendant la saisie ; les erreurs de syntaxe indiquent la ligne et la colonne.
- Vous pouvez ouvrir Valider avec un schéma et coller votre SDL pour vérifier chaque champ et argument.
- 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) ?
Peut-il récupérer mon schéma depuis un endpoint ?
rover graph introspect, get-graphql-schema ou depuis le code de votre serveur.