Aller au contenu
Tout en local

Formateur GraphQL

Formatez ou minifiez une requête, mutation, fragment ou schéma GraphQL avec une indentation cohérente.

Entrée
Sortie

Formateur GraphQL

Collez une requête, mutation, fragment ou schéma GraphQL et cet outil le reformate avec une indentation cohérente et lisible, ou le minifie en une seule ligne pour une transmission sur le réseau. Il comprend la structure partagée par les opérations et les définitions de type, ainsi une requête avec des ensembles de sélection imbriqués et un schéma plein de blocs de type sortent correctement indentés, avec les champs, arguments, directives et définitions de variables au bon endroit.

Choisissez la largeur d'indentation (2 espaces, 4 espaces ou une tabulation), ou activez « Minifier au lieu de formater » pour supprimer les espaces et les commentaires jusqu'au plus petit document valide. « Trier les champs alphabétiquement » réorganise les champs dans chaque ensemble de sélection ou bloc de type, utile pour repérer un champ manquant ou dupliqué dans une longue requête. « Réduire les variables de requête sur une seule ligne » décide si la liste `$variable: Type` `$variable: Type` reste sur une seule ligne ou se divise en sa propre ligne indentée par variable, et « Ligne vierge entre les opérations » ajoute un espacement lorsque l'entrée comporte plus d'une requête, mutation ou fragment.

L'outil valide également pendant le formatage : les parenthèses non appariées ou non fermées sont rapportées au lieu d'être devinées, et un ensemble de sélection qui propage un fragment (``...MyFragment`) sans définition correspondante dans le texte collé obtient sa ligne signalée. Le compteur en direct signale combien de définitions ont été trouvées et à quelle profondeur la requête s'imbrique, un signal d'alerte précoce pour une requête sur-extraite.

Le formatage s'exécute entièrement dans votre navigateur ; rien de ce que vous collez n'est téléchargé, ce qui importe pour les schémas et les requêtes qui font référence à des noms de champs ou de types internes. Copiez le résultat, téléchargez-le en tant que fichier .txt, ou renvoyez la sortie à l'entrée pour appliquer un autre passage avec d'autres options.

FAQ

Fonctionne-t-il sur les définitions de schéma (SDL), et pas seulement les requêtes ?
Oui. Les blocs de type, interface, entrée, énumération, union, scalaire et schéma sont tous formatés avec la même indentation cohérente que les opérations, et « Trier les champs alphabétiquement » s'applique également à leurs champs.
Que se passe-t-il si ma requête référence un fragment qui n'est pas dans l'entrée ?
L'outil formate toujours le reste du document, mais la ligne propageant le fragment manquant est signalée pour que vous puissiez coller sa définition ou corriger une faute de frappe dans son nom.
Puis-je l'utiliser pour réduire une requête avant de l'envoyer sur le réseau ?
Oui, activez « Minifier au lieu de formater » pour supprimer les commentaires et les espaces non essentiels jusqu'au plus petit document valide, en gardant la requête sémantiquement identique.
Les commentaires sont-ils conservés ?
Par défaut, oui : les commentaires # et les chaînes de description sont conservés sur leur propre ligne au-dessus de ce qu'ils décrivent. Désactivez « Conserver les commentaires » pour les supprimer, ce qui se produit également automatiquement lors de la minification.
Ma requête ou mon schéma est-il téléchargé quelque part ?
Non. Le formatage et la minification s'exécutent entièrement dans votre navigateur ; rien de ce que vous collez ne quitte jamais votre appareil.