Validator voor GraphQL-query's
Controleer GraphQL-query's, mutaties en fragmenten aan de hand van je schema voordat je ze verzendt. Plak SDL of introspectie-JSON en bekijk ondersteunde validatiefouten met hun regel en kolom.
Accepteert maximaal 200.000 tekens aan operaties, een schema van maximaal 1.000.000 tekens en variabelen van maximaal 200.000 tekens. Documenten zijn beperkt tot 100.000 tokens en 64 nestingsniveaus, schema's tot 10.000 typen. De validatie draait in je browser in een achtergrondworker en er wordt niets naar een GraphQL-server verzonden. Downloads zijn een JSON-rapport en een CSV-lijst met fouten. Query's, mutaties, abonnementen en fragmenten. Plaats het schema in het veld Gegevensschema. Maximaal 200.000 tekens. Controleer de instellingen voordat je de tool uitvoert.
Je resultaat
Validator voor GraphQL-query's
- Plak je GraphQL-operaties en -fragmenten in het hoofdvak.
- Plak het schema als SDL of introspectie-JSON in het veld Gegevensschema.
- Voeg eventueel de variabelen toe als JSON-object.
- Voer de controle uit, bekijk daarna elke geschonden regel en download het JSON- of CSV-rapport.
Wat je kunt verwachten
Accepteert maximaal 200.000 tekens aan operaties, een schema van maximaal 1.000.000 tekens en variabelen van maximaal 200.000 tekens. Documenten zijn beperkt tot 100.000 tokens en 64 nestingsniveaus, schema's tot 10.000 typen. De validatie draait in je browser in een achtergrondworker en er wordt niets naar een GraphQL-server verzonden. Downloads zijn een JSON-rapport en een CSV-lijst met fouten.
Wat wordt gecontroleerd
De validator controleert ondersteunde regels voor velden en retourtypen, blad- en objectselecties, argumenten en verplichte argumenten, fragmentnamen, doelen, cycli en ongebruikte fragmenten, waarden en invoerobjecten inclusief @oneOf, richtlijnen en hun locaties en variabeledefinities, gebruik en typen. Als je variabelen toevoegt, worden hun waarden ook aan de gedeclareerde typen getoetst. De beperkingen hieronder beschrijven waar deze eigen implementatie ophoudt.
Zo werkt het
Happytails.ai gebruikt een eigen begrensde GraphQL-parser en -validator, niet graphql-js. Conflicten tussen antwoordnamen worden vergeleken tussen fragmenten en samengevoegde onderliggende selecties, inclusief retourstructuur, argumenten en elkaar uitsluitende objecttakken. __schema en __type vereisen een selectieset, maar hun introspectiesubvelden worden niet gevalideerd. Dit is geen volledige GraphQL-implementatie.
Het rapport lezen
Elke fout vermeldt de validatieregel, een korte uitleg en het regel- en kolomnummer in je operaties. Het schema zelf moet bruikbaar zijn: een ontbrekend Query-type of een veld dat naar een ongedefinieerd type verwijst, stopt de controle met een melding in plaats van een lijst.