Saltar al contenido

Formateador GraphQL

Formatea o minifica una consulta, mutación, fragmento o esquema GraphQL con sangría consistente.

Entrada
Salida

Formateador GraphQL

Pega una consulta GraphQL, mutación, fragmento o esquema y esta herramienta lo reformatea con sangría consistente y legible, o lo minifica en una única línea para transmitir por la red. Entiende la estructura compartida por operaciones y definiciones de tipo, por lo que una consulta con conjuntos de selección anidados y un esquema lleno de bloques de tipo salen con una sangría limpia, con campos, argumentos, directivas y definiciones de variables en el lugar correcto.

Elige el ancho de sangría (2 espacios, 4 espacios o una tabulación), o activa «Minificar en lugar de formatear» para eliminar espacios en blanco y comentarios hasta el documento válido más corto. «Ordenar campos alfabéticamente» reordena los campos dentro de cada conjunto de selección o bloque de tipo, útil para detectar un campo faltante o duplicado en una consulta larga. «Contraer variables de consulta en una línea» decide si la lista `$variable: Type` `$variable: Type` permanece en una línea o se divide en su propia línea indentada por variable, y «Línea en blanco entre operaciones» añade espaciado cuando la entrada tiene más de una consulta, mutación o fragmento.

La herramienta también valida mientras formatea: los paréntesis no coincidentes o no cerrados se reportan en lugar de adivinarse, y un conjunto de selección que propaga un fragmento (``...MyFragment`) sin definición coincidente en el texto pegado recibe su línea marcada. El contador en vivo informa cuántas definiciones se encontraron y qué tan profundamente anida la consulta, una señal de alerta temprana para una consulta que sobre-captura.

El formateo se ejecuta completamente en tu navegador; nada de lo que pegues se sube, lo cual importa para esquemas y consultas que hacen referencia a nombres de campo o tipo internos. Copia el resultado, descárgalo como archivo .txt, o envía la salida de vuelta a la entrada para aplicar otro pase con diferentes opciones.

Preguntas frecuentes

¿Funciona en definiciones de esquema (SDL), no solo en consultas?
Sí. Los bloques de tipo, interfaz, entrada, enumeración, unión, escalar y esquema se formatean todos con la misma sangría consistente que las operaciones, y «Ordenar campos alfabéticamente» también se aplica a sus campos.
¿Qué pasa si mi consulta hace referencia a un fragmento que no está en la entrada?
La herramienta sigue formateando el resto del documento, pero la línea que propaga el fragmento faltante se marca para que puedas pegar su definición o corregir un error tipográfico en su nombre.
¿Puedo usar esto para reducir una consulta antes de enviarla por la red?
Sí, activa «Minificar en lugar de formatear» para eliminar comentarios y espacios en blanco no esenciales hasta el documento válido más pequeño, manteniendo la consulta semánticamente idéntica.
¿Se conservan los comentarios?
Por defecto, sí: los comentarios # y las cadenas de descripción se mantienen en su propia línea encima de lo que describen. Desactiva «Conservar comentarios» para eliminarlos, lo que también sucede automáticamente al minificar.
¿Mi consulta o esquema se carga en algún lugar?
No. El formateo y la minificación se ejecutan completamente en tu navegador; nada de lo que pegues sale nunca de tu dispositivo.