GraphQL-Dokumente

GraphQL-FormatiererPrüfumfang sichtbar machen

Bearbeiten Sie Operationen, SDL oder JSON-Variablen. Für die Feldprüfung einer Operation benötigen Sie ein vollständiges Schema im SDL-Format.

GraphQL-Formatierer

Eingabe

Ergebnis

Die Verarbeitung erfolgt in diesem Browser. Keine API-Anfragen, kein gespeicherter Verlauf und keine Eingaben in URLs.

Optionen

Ohne Schema wird nur die Syntax geprüft. Vollständiges SDL ermöglicht statische Feld- und Typprüfungen. Variablen werden nur als JSON-Objekt geprüft; ihre Werte werden nicht mit den deklarierten Typen abgeglichen.

Dokument und Schema: jeweils 100.000 Zeichen; Variablen: 20.000. GraphQL: 20.000 Tokens, 100 Verschachtelungsebenen; Abbruch nach 8 Sekunden.

Geben Sie ein Dokument ein oder laden Sie ein Beispiel.

Der GraphQL-Formatierer hilft bei der Prüfung einer Abfrage aus einem Log: Verschachtelte Auswahlen werden lesbar, und Fragmentdefinitionen bleiben neben den Operationen erhalten. Die Ausgabe überschreibt den eingefügten Quelltext nicht.

Ein GraphQL-Formatter kann gültige Syntax erzeugen, obwohl ein Feld im Zielsystem fehlt. Achten Sie deshalb auf den Status: Er unterscheidet die reine Syntaxprüfung von der statischen Prüfung anhand Ihres Schemas.

Wozu dieser GraphQL-Formatierer dient

Definitionen zusammen prüfen

Der GraphQL-Formatierer rückt Auswahlmengen mit zwei Leerzeichen ein und gibt das gesamte Dokument aus. Die Strukturansicht zeigt Operationen, Variablen und Fragmente mit Quellzeilen. Referenzen bleiben Referenzen; fehlende Definitionen werden nicht ergänzt.

Ein kompaktes Dokument wird in eingerückte Zeilen aufgeteilt, daneben steht das Variablenobjekt in einer eigenen Karte.

Felder am Vertrag messen

Ein GraphQL-Validator benötigt das passende GraphQL-Schema, um unbekannte Felder zu erkennen. Fügen Sie vollständiges SDL hinzu, um Auswahlen, Argumente und Fragmentbeziehungen statisch zu prüfen. Fehler nennen die betroffene Eingabe.

Eine Abfrage besteht die Syntaxprüfung; beim Abgleich mit einem Schema wird ein unpassendes Feld hervorgehoben.

Drei Entscheidungen vor dem Export

01

Passenden Dokumenttyp wählen

Operationen umfassen Queries, Mutations, Subscriptions und Fragmente. Einzelne type- oder extend-Definitionen gehören in den SDL-Modus, der keine Query-Wurzel verlangt. Für Variablen allein gibt es einen unabhängigen JSON-Modus.

02

Das Schema getrennt ergänzen

Im Operationsmodus behalten die Register Dokument, Schema und Variablen ihre Inhalte. Das Beispiel enthält alle drei Teile. Vor dem Ersetzen sehen Sie die neuen Inhalte und Zeichenmengen; Rückgängig stellt den vorherigen Stand wieder her.

03

Aktuellen Stand verarbeiten

Eine GraphQL-Query formatieren Sie automatisch nach 400 ms Eingabepause. Ohne Automatik verwenden Sie die Schaltfläche oder Strg/Cmd+Enter. Geänderte Eingaben sperren den Export; reine Ansichtswechsel verwenden das bestehende Ergebnis.

Ansichten für die Dokumentprüfung

Lesbare und kompakte Ausgabe

Die formatierte Ansicht erleichtert Code-Reviews, die minimierte entfernt entbehrliche Zeichen. Erforderliche Trenner zwischen Namen, Zeichenkettenwerte und die Feldreihenfolge bleiben erhalten. Abfragen werden nicht zur Leistungsoptimierung umgeschrieben.

Struktur mit Quellzeilen

Operationen, Variablendeklarationen, Fragmente, Felder und SDL-Typen erscheinen in einer Liste mit jeweils 100 weiteren Einträgen. Der JSON-Export der Struktur enthält auch noch nicht eingeblendete Einträge. Die Anzahl ist keine Kostenberechnung.

Variablen ohne Zahlenrundung

Zahlentexte wie 9007199254740993 und 1.2300e+40 bleiben unverändert. Auch wie Zahlen aussehende Objektschlüssel behalten ihre Eingabereihenfolge. Doppelte Schlüssel lösen einen Fehler aus, anstatt einen Wert unbemerkt zu ersetzen.

Fehler an der richtigen Eingabe

Syntaxfehler zeigen nach Möglichkeit Zeile und Spalte. Ein Klick führt zum betroffenen Register. Bei Schemafehlern bleibt ein syntaktisch korrektes Dokument formatiert sichtbar, während Kopieren und Herunterladen gesperrt sind.

Grenzen der Prüfung

Keine Ausführung oder Wertkonvertierung
Das Werkzeug sendet keine Operation an einen Server. Pflichtwerte, Laufzeitkonvertierung, eigene Skalare und Geschäftsregeln werden bei Variablen nicht geprüft. Deklarierte Variablentypen im Dokument gehören hingegen zur statischen Prüfung.
Vollständiges SDL für das optionale Schema
Introspection-JSON und entfernte URLs werden nicht importiert. Query-Wurzel, referenzierte Typen und eigene Direktiven müssen enthalten sein. Federation-Komposition und Codegenerierung sind nicht vorgesehen. Der eigenständige SDL-Modus prüft nur Syntax.
Kommentare sind keine Beschreibungen
Formatierung und Minimierung entfernen #-Kommentare. SDL-Beschreibungszeichenketten bleiben Teil der Syntax. Der Quelltext bleibt in der Eingabe erhalten. Automatische Reparatur, Feldsortierung und das Laden externer Fragmente sind nicht verfügbar.
Begrenzte Arbeit statt stiller Kürzung
Dokument und Schema dürfen jeweils 100.000 Zeichen, Variablen 20.000 Zeichen enthalten. GraphQL ist auf 20.000 Tokens und 100 geschachtelte Begrenzer beschränkt; JSON ebenfalls auf 100 Ebenen. Nach 8 Sekunden wird der Worker beendet. Teilen Sie größere Dokumente auf.

Fragen zum GraphQL-Formatierer

Wie lässt sich die GraphQL-Syntax einer Editoreingabe prüfen?

Ein Parser kann GraphQL-Grammatik ohne Schema prüfen. Lassen Sie im Operationsmodus das Schema leer, wird nur die Syntax bestätigt. Ob ein Feld im Zielsystem existiert oder eine Operation ausführbar ist, folgt daraus nicht.

Wie prüfe ich GraphQL-Operationen gegen das Schema des Servers?

Fügen Sie das vollständige Server-SDL im Register Schema ein und die Operation samt benötigten Fragmenten im Dokument. Die statischen Regeln prüfen Felder, Argumente und deklarierte Typen. Authentifizierung, Ausführung und Resolver werden nicht getestet.

Warum werden meine GraphQL-Variablen als ungültiges JSON gemeldet?

Variablen brauchen striktes JSON, keine GraphQL-Objektnotation und kein Dictionary einer Programmiersprache. Verwenden Sie doppelte Anführungszeichen für Schlüssel und Strings, entfernen Sie abschließende Kommas und geben Sie ein Objekt als Wurzel an. Doppelte Schlüssel werden abgelehnt.

Warum erscheint „Query root type must be provided“?

Dem als vollständig angegebenen Schema fehlt eine gültige Query-Wurzel. Definieren Sie type Query oder verweisen Sie in einer schema-Deklaration auf einen vorhandenen Objekttyp. Zum Formatieren einzelner Typen oder Erweiterungen genügt der SDL-Modus.

Warum fehlt beim Ausgeben einer GraphQL-Abfrage die Fragmentdefinition?

Das Drucken eines einzelnen Operationsknotens ergänzt keine anderswo liegenden Fragmentdefinitionen. Hier wird das gesamte eingefügte Dokument ausgegeben. Fügen Sie benötigte Definitionen im selben Dokument hinzu; externe Dateien werden weder geladen noch automatisch eingebettet.

Ein konkretes Dokument macht Probleme?

Bereit für die nächste Prüfung

Nutzen Sie den GraphQL-Formatierer, prüfen Sie den ausgewiesenen Umfang und exportieren Sie anschließend die aktuelle Ansicht.