Aller au contenu

Formateur GraphQL

GraphQL Formatter

Met en forme requêtes et SDL, valide un document contre un schéma et affiche le type auquel il se résout.

Réimprime un document GraphQL dans le style conventionnel — un champ par ligne, les arguments espacés, l'indentation par profondeur de sélection. Il analyse toute la grammaire d'octobre 2021 : un fichier de schéma avec directives, interfaces et unions passe donc aussi facilement qu'une requête.

🔒 Fonctionne entièrement dans votre navigateurgraphqlformatschema

GraphQL en entrée

Formaté

Flux de jetons

identique à l’entrée

Analyse toute la grammaire d’octobre 2021 — opérations, fragments et l’ensemble du langage du système de types — et la réimprime dans le style conventionnel. Les commentaires sont gardés, les virgules sont normalisées et disparaissent (ce sont des jetons ignorés), et à chaque passage on vérifie que la sortie porte exactement les jetons de l’entrée.

Comment s’en servir

  1. Collez le document ou ouvrez un fichier

    Une requête, une mutation, un fragment, ou tout un schéma `.graphql`. Les opérations anonymes comme les nommées conviennent.

  2. Vérifiez la ligne du flux de jetons

    Après chaque passage, le formateur redécoupe sa propre sortie en jetons et la compare à l'entrée. La statistique dit « identique à l'entrée » quand rien d'autre que la mise en page n'a bougé — et elle crie dans le cas contraire.

  3. Copiez ou téléchargez le résultat

    Le téléchargement est un fichier `.graphql` avec le bon type MIME, prêt à être déposé dans un répertoire de schémas.

Questions fréquentes

Où sont passées mes virgules ?

GraphQL traite les virgules comme des jetons ignorés — ce sont des espaces avec une forme. Le formateur les normalise en les retirant parce que le style conventionnel n'en a pas, et aucun sens ne se perd à les supprimer.

Les commentaires sont-ils gardés ?

Oui, et la comparaison faite après chaque passage le vérifie aussi — les jetons de commentaire de la sortie doivent correspondre à ceux qui sont entrés. Un formateur qui supprime la ligne `# deprecated` au-dessus d'un champ a cassé le document, du point de vue du prochain lecteur.

Valide-t-il la requête par rapport à un schéma ?

Non. Il vérifie la grammaire, pas le sens — une requête qui demande un champ inexistant est syntaxiquement parfaite et se formate très bien. La validation demande le schéma, que cette page n'a jamais.

À alimenter depuis

Ensuite

Ces outils acceptent ce que celui-ci produit : le résultat peut y aller directement.