#291 · Herramienta para desarrolladores

Extractor de variables de consultas GraphQL

Analiza operaciones GraphQL y separa las variables declaradas en la firma de cada operación de las referencias $variable usadas en argumentos y directivas. El resultado permite localizar variables faltantes, declaraciones que ya no se usan y tipos asociados sin enviar la consulta a ningún servidor.

Datos de entrada

Consulta o documento GraphQL
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Pega el contenido en el área de entrada o carga un archivo compatible.
  2. Ajusta las opciones disponibles si aparecen para este análisis.
  3. Pulsa el botón principal o usa Ctrl/Cmd + Enter.
  4. Revisa el resumen, las métricas y el resultado antes de copiarlo o descargarlo.

Qué hace esta herramienta para desarrolladores

Separa las declaraciones de variables de las referencias usadas en el documento y crea una comparación directa entre ambas.

Procesamiento 100 % local mediante tokenización y reglas estructurales específicas de GraphQL.

No se realizan peticiones de red ni se ejecuta código del documento introducido.

Ejemplo

Entrada: usa el ejemplo incluido en el botón «Ejemplo».

Salida esperada: Lista JSON con variables declaradas, usadas, faltantes y sin uso.

Casos de uso

  • Revisiones de pull request y cambios de contratos GraphQL.
  • Depuración local de consultas o esquemas antes de probarlos contra una API.
  • Documentación técnica y comparación de artefactos GraphQL.

Consejos para obtener resultados fiables

  • Trabaja con una copia del documento antes de transformar contenido.
  • Revisa los mensajes de interpretación junto con la salida generada.
  • Usa entradas representativas de producción para detectar límites reales.
  • No pegues secretos si vas a compartir capturas o resultados.
  • Contrasta los hallazgos estructurales con las reglas de tu servidor GraphQL.

Detalles del procesamiento

Separa las declaraciones de variables de las referencias usadas en el documento y crea una comparación directa entre ambas.

No valida las variables contra los tipos del esquema ni comprueba coerción de valores.

Preguntas frecuentes

¿Cómo detecta variables GraphQL declaradas pero no utilizadas?

Compara los nombres definidos en la firma de la operación con las referencias $nombre encontradas en argumentos y directivas.

¿El extractor valida que el tipo de cada variable exista en el esquema?

No. Lee el tipo declarado en la consulta, pero no dispone del esquema para comprobar que ese tipo esté definido.

¿Puede encontrar variables usadas dentro de directivas @include y @skip?

Sí, las referencias con $ dentro de los argumentos de directivas se cuentan como usos.

¿Qué significa una variable “sin declarar”?

Que aparece una referencia $variable en el documento pero no se encontró una declaración correspondiente en la firma de una operación.

¿Se envía la consulta GraphQL a algún servidor?

No. El análisis se realiza localmente en el navegador.

Resumen del módulo

MóduloResultado
EntradaConsulta o documento GraphQL
ProcesamientoAnálisis local en el navegador
SalidaLista JSON con variables declaradas, usadas, faltantes y sin uso.

Explora API y GraphQL

Consulta más utilidades de análisis, generación y validación para contratos API y documentos GraphQL.

Ver categoría API y GraphQL