#292 · Herramienta para desarrolladores

Analizador de profundidad de consultas GraphQL

Calcula la profundidad real de los selection sets de una operación GraphQL e incorpora los fragmentos nombrados cuando se expanden lógicamente. También cuenta campos, spreads y fragmentos inline para ofrecer una lectura rápida del tamaño estructural de la consulta.

Datos de entrada

Consulta 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

Recorre los selection sets y calcula la rama más profunda, incluyendo expansiones lógicas de fragmentos nombrados.

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: JSON con maxDepth, totalFields y métricas de fragmentos.

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

Recorre los selection sets y calcula la rama más profunda, incluyendo expansiones lógicas de fragmentos nombrados.

La profundidad es una métrica estructural y no mide el coste de resolvers ni el número de filas devueltas.

Preguntas frecuentes

¿Qué se considera un nivel de profundidad en una consulta GraphQL?

Cada campo seleccionado dentro de otro selection set incrementa la profundidad de esa rama.

¿Los fragmentos GraphQL cuentan para la profundidad total?

Sí. Los fragmentos nombrados se incorporan lógicamente al calcular la rama donde se usan.

¿Una profundidad alta significa siempre que la consulta es peligrosa?

No necesariamente. Es una señal estructural; el coste real depende de resolvers, cardinalidad y límites del servidor.

¿El analizador detecta fragmentos inline?

Sí, los fragmentos inline se recorren como parte de la jerarquía de selección.

¿Qué profundidad máxima debería permitir una API GraphQL?

No existe un valor universal. Debe definirse según el esquema, los resolvers y la estrategia de protección del servidor.

Resumen del módulo

MóduloResultado
EntradaConsulta GraphQL
ProcesamientoAnálisis local en el navegador
SalidaJSON con maxDepth, totalFields y métricas de fragmentos.

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