#298 · Herramienta para desarrolladores

Comprobador de diferencias de esquemas GraphQL

Compara dos versiones de un esquema GraphQL SDL pegadas en un único cuadro separadas por una línea con ---SCHEMA---. Detecta tipos y campos añadidos o eliminados y cambios de tipo en campos existentes, clasificando como potencialmente incompatibles las eliminaciones y los cambios de firma.

Datos de entrada

Esquema anterior y nuevo
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

Construye mapas de tipos y campos para dos versiones del SDL y clasifica adiciones, eliminaciones y cambios de tipo.

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 de cambios con indicador breaking.

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

Construye mapas de tipos y campos para dos versiones del SDL y clasifica adiciones, eliminaciones y cambios de tipo.

La comparación actual no cubre argumentos, directivas, valores de enum ni todas las reglas de compatibilidad GraphQL.

Preguntas frecuentes

¿Qué cambios de esquema GraphQL se marcan como potencialmente incompatibles?

La eliminación de tipos o campos y los cambios de tipo de campos existentes se marcan como breaking potencial.

¿Añadir un campo nuevo se considera breaking change?

En este análisis básico se clasifica como adición no breaking, aunque políticas específicas del proyecto podrían aplicar reglas adicionales.

¿Cómo separo el esquema anterior del nuevo?

Coloca una línea que contenga exactamente ---SCHEMA--- entre ambos bloques SDL.

¿El comparador analiza cambios en argumentos, directivas o valores de enum?

Esta versión se centra en tipos y campos. Esos cambios requieren una validación de compatibilidad más profunda.

¿Puede sustituir herramientas de schema registry o GraphQL Inspector?

No. Sirve para una revisión local rápida; un registry puede aplicar reglas semánticas y contexto de uso más amplios.

Resumen del módulo

MóduloResultado
EntradaEsquema anterior y nuevo
ProcesamientoAnálisis local en el navegador
SalidaLista JSON de cambios con indicador breaking.

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