Cómo usar: Formateador y validador de GraphQL
- Pega una consulta, mutación, suscripción, fragmento o esquema GraphQL (SDL).
- Se formatea mientras escribes; los errores de sintaxis muestran la línea y la columna.
- Opcionalmente, abre Validar contra un esquema y pega tu SDL para comprobar cada campo y argumento.
- Copia el resultado formateado o minificado.
Qué comprueba el validador
Sin esquema, la herramienta comprueba la sintaxis: llaves equilibradas, nombres válidos, sintaxis de argumentos y variables, y escapes de cadenas y cadenas de bloque. Con un esquema ejecuta el conjunto completo de reglas de validación de GraphQL de la especificación, las mismas que aplica un servidor GraphQL antes de ejecutar una consulta:
- Cada campo existe en su tipo, y los campos hoja (escalares, enums) no tienen selección mientras que los campos objeto sí la tienen.
- Los argumentos existen, los obligatorios se proporcionan y los valores tienen el tipo correcto.
- Las variables están declaradas, se usan y sus tipos encajan donde se utilizan.
- Los fragmentos se usan, coinciden con el tipo en el que se aplican y no forman ciclos.
- Los nombres de operación son únicos y las operaciones anónimas van solas.
Formatear y minificar
El formateo usa la función de referencia print de graphql-js, así que la salida coincide con la de la mayoría de herramientas GraphQL: sangría de dos espacios, un campo por línea y espaciado normalizado de argumentos. La minificación elimina comentarios y espacios en blanco irrelevantes, útil para peticiones GET y consultas persistidas, donde cada byte cuenta. ¿Necesitas construir una consulta a partir de un esquema? Usa el constructor de consultas GraphQL.
También se busca como: formateador graphql, validador graphql, formatear consulta graphql, validar esquema graphql, minificar graphql, comprobador sintaxis graphql, validador sdl graphql, graphql prettify.
Herramientas que combinan con: Formateador y validador de GraphQL
- Formateador JSON — Pega el código JSON para formatearlo, minimizarlo o validarlo.
- Validador OpenAPI / Swagger — Pega una especificación de API para comprobarla contra el esquema oficial de OpenAPI, detectar referencias rotas y parámetros de ruta inconsistentes, y ver todos los endpoints de un vistazo.
- Validador JSON Schema — Pega un schema y algunos datos JSON para ver exactamente qué valores incumplen cada regla, o genera un schema inicial a partir de datos de ejemplo.
- Webhook Tester — Obtén una URL única, apunta cualquier webhook o cliente HTTP hacia ella y mira cómo llegan las peticiones en tiempo real: cabeceras, query string y cuerpo formateado, además de comprobaciones de firma HMAC.
Preguntas frecuentes
¿Admite archivos de esquema (SDL)?
¿Puede obtener mi esquema desde un endpoint?
rover graph introspect, get-graphql-schema o desde el código de tu servidor.