GraphQL-Schema-Explorer

Laden Sie das Schema und fügen Sie eine Operation ein, um die Root-Felder, die gefundenen Auswahlen und eine bearbeitbare Variablenvorlage zu sehen. Alles läuft im Browser; diese Teilprüfungen ersetzen keine vollständige GraphQL-Validierung.

Läuft lokal in deinem Browser
Analyse und Auswertung erfolgen vollständig in deinem Browser. Es werden keine Daten hochgeladen oder an eine API gesendet.
Schema oder Introspektions-JSON
Zu prüfende Operation

Dies ist eine Schema- und Query-Hilfe. Operation, Variablen und Schema werden nicht an einen GraphQL-Endpunkt gesendet.

Schema-Zusammenfassung
  • Fügen Sie ein Schema ein, um Typen, Root-Felder und eine lokale Operation zu prüfen.
Variablenvorlage
Typen und Root-Felder
  • Fügen Sie ein Schema ein, um Typen, Root-Felder und eine lokale Operation zu prüfen.

GraphQL-Struktur vor der Verwendung eines API-Clients prüfen

Der Explorer erkennt gängiges SDL und Introspektion, prüft Root-Felder und erstellt ein erstes Variablenobjekt. Er ersetzt keine serverseitige GraphQL-Validierung.

So verwenden Sie den „GraphQL-Schema-Explorer“

Der Explorer liest ein GraphQL-Schema als SDL oder als Introspection-JSON und listet alle gefundenen Typen zusammen mit den Root-Typen des Schemas auf.

Fügen Sie unter dem Schema eine Operation ein, um ihre Root-Auswahlen gegen den passenden Root-Typ zu prüfen und eine Variablenvorlage zu erzeugen. Analyse und Prüfung laufen im Browser; es wird nichts an einen Endpunkt gesendet.

  1. Fügen Sie SDL oder Introspection-JSON links ein oder laden Sie eine .graphql-, .json- oder .txt-Datei.
  2. Fügen Sie rechts die zu prüfende Query, Mutation oder Subscription ein.
  3. Klicken Sie auf Schema und Anfrage prüfen: die Zusammenfassung zählt Typen und Root-Felder, die Befunde markieren jede Root-Auswahl als vorhanden oder fehlend.
  4. Kopieren Sie die Variablenvorlage und füllen Sie echte Werte ein, bevor Sie die Operation im API-Client ausführen.

Hintergrund und Genauigkeit

Was die Prüfung abdeckt

Das Schema wird mit einem Tokenizer gelesen, der Beschreibungen, Kommentare, Direktiven und Standardwerte versteht. Typen und Felder überstehen damit geschweifte Klammern in Standardwerten oder Beschreibungen, und Enum-Werte werden nicht mit ihren Direktiven vermischt.

Aus der eingefügten Operation nimmt der Explorer die erste Query, Mutation oder Subscription und überspringt Fragmentdefinitionen. Die Auswahlen der obersten Ebene — inklusive Aliase — werden mit den Feldern des passenden Root-Typs verglichen.

Root-Typen und Auswahlen

Ein Schema definiert seine Roots in einem schema { ... }-Block oder über die Standardnamen Query, Mutation und Subscription. Der Block hat Vorrang: ein Typ namens Query ist nur dann Root, wenn der Block query darauf abbildet.

Fragment-Spreads und Inline-Fragmente zählen nicht als Felder. Eine Query wird gegen die Query-Root, eine Mutation gegen Mutation und eine Subscription gegen Subscription geprüft; fehlt dieser Root-Typ, sagt der Explorer das, statt ein falsches Feld zu melden.

Variablenvorlage

Jede Variable der Operation erhält einen Beispielwert: String und ID werden zu "example", Int und Float zu 0, Boolean zu false, Enums nutzen ihren ersten Wert, und Eingabeobjekte werden mit ihren eigenen Feldern aufgebaut.

Listentypen erzeugen Arrays ([ID!]! wird zu ["example"]); tief verschachtelte Eingaben fallen nach drei Ebenen auf "example" zurück. Die Vorlage ist ein Startpunkt und wird nie hochgeladen oder ausgeführt.

Zuletzt verwendet: