Zum Inhalt springen

GraphQL formatieren

GraphQL Formatter

Formatiert Queries und SDL, validiert ein Dokument gegen ein Schema und gibt den aufgelösten Typ aus.

Gibt ein GraphQL-Dokument im üblichen Stil neu aus – ein Feld pro Zeile, Argumente mit Abständen, Einrückung nach Auswahltiefe. Es parst die vollständige Grammatik vom Oktober 2021, sodass eine Schemadatei mit Direktiven, Interfaces und Unions ebenso durchgeht wie eine Query.

🔒 Läuft vollständig in Ihrem Browsergraphqlformatschema

GraphQL-Eingabe

Formatiert

Tokenstrom

identisch mit der Eingabe

Liest die vollständige Grammatik von Oktober 2021 — Operationen, Fragmente und die ganze Typsystem-Sprache — und druckt sie im üblichen Stil neu. Kommentare bleiben, Kommas werden wegnormalisiert (sie sind ignorierte Token), und bei jedem Durchlauf wird geprüft, dass die Ausgabe genau die Token der Eingabe trägt.

So funktioniert es

  1. Fügen Sie das Dokument ein oder öffnen Sie eine Datei

    Eine Query, eine Mutation, ein Fragment oder ein ganzes `.graphql`-Schema. Anonyme und benannte Operationen sind beide in Ordnung.

  2. Prüfen Sie die Token-Stream-Zeile

    Nach jedem Durchlauf tokenisiert der Formatierer seine eigene Ausgabe erneut und vergleicht sie mit der Eingabe. Die Angabe sagt „identisch mit der Eingabe“, wenn sich nichts außer dem Layout bewegt hat – und schlägt Alarm, wenn nicht.

  3. Kopieren Sie das Ergebnis oder laden Sie es herunter

    Der Download ist eine `.graphql`-Datei mit dem richtigen MIME-Typ, bereit zum Ablegen in einem Schemaverzeichnis.

Häufige Fragen

Wo sind meine Kommas hin?

GraphQL behandelt Kommas als ignorierte Tokens – sie sind Whitespace mit einer Form. Der Formatierer normalisiert sie weg, weil der übliche Stil keine hat, und durch ihr Entfernen geht keine Bedeutung verloren.

Bleiben Kommentare erhalten?

Ja, und der Vergleich nach jedem Durchlauf prüft auch das – die Kommentar-Tokens in der Ausgabe müssen denen entsprechen, die hineingingen. Ein Formatierer, der die Zeile `# deprecated` über einem Feld verwirft, hat das Dokument aus Sicht des nächsten Lesers kaputt gemacht.

Validiert es die Query gegen ein Schema?

Nein. Es prüft die Grammatik, nicht die Bedeutung – eine Query, die nach einem Feld fragt, das es nicht gibt, ist syntaktisch perfekt und formatiert sich problemlos. Validierung braucht das Schema, das diese Seite nie hat.

Eingabe aus

Danach

Diese Tools nehmen an, was dieses hier erzeugt, das Ergebnis kann also direkt weiter.