Saltar al contenido

Formateador de GraphQL

GraphQL Formatter

Formatea consultas y SDL, valida un documento contra un esquema e imprime el tipo al que resuelve.

Reimprime un documento GraphQL en el estilo convencional: un campo por línea, argumentos con espacios, indentación por profundidad de selección. Analiza la gramática completa de octubre de 2021, así que un archivo de esquema con directivas, interfaces y uniones pasa con la misma facilidad que una consulta.

🔒 Se ejecuta por completo en tu navegadorgraphqlformatschema

GraphQL de entrada

Formateado

Flujo de tokens

idéntico a la entrada

Analiza la gramática completa de octubre de 2021 — operaciones, fragmentos y todo el lenguaje del sistema de tipos — y la vuelve a imprimir con el estilo de siempre. Los comentarios se conservan, las comas se normalizan y desaparecen (son tokens ignorados), y en cada pasada se comprueba que la salida lleva exactamente los tokens de la entrada.

Cómo se usa

  1. Pega el documento o abre un archivo

    Una consulta, una mutación, un fragmento o un esquema `.graphql` entero. Las operaciones anónimas y las con nombre valen las dos.

  2. Comprueba la línea del flujo de tokens

    Tras cada ejecución, el formateador vuelve a tokenizar su propia salida y la compara con la entrada. La estadística dice «idéntico a la entrada» cuando solo se movió la disposición, y grita si no fue así.

  3. Copia o descarga el resultado

    La descarga es un archivo `.graphql` con el tipo MIME correcto, listo para soltarlo en un directorio de esquemas.

Preguntas frecuentes

¿Adónde fueron mis comas?

GraphQL trata las comas como tokens ignorados: son espacio en blanco con forma. El formateador las normaliza eliminándolas porque el estilo convencional no lleva ninguna, y no se pierde ningún significado al quitarlas.

¿Se conservan los comentarios?

Sí, y la comparación tras cada ejecución también lo comprueba: los tokens de comentario de la salida tienen que coincidir con los que entraron. Un formateador que elimina la línea `# deprecated` sobre un campo ha roto el documento para el siguiente lector.

¿Valida la consulta contra un esquema?

No. Comprueba la gramática, no el significado: una consulta que pide un campo que no existe es sintácticamente perfecta y se formatea bien. La validación necesita el esquema, que esta página nunca tiene.

Puede recibir de

Después

Estas aceptan lo que produce esta herramienta, así que el resultado puede pasar directamente.