Formatador de Schema GraphQL

Cole um schema GraphQL — definições de type, interface, enum, input, scalar, union ou directive escritas em SDL (Schema Definition Language) — e receba de volta uma versão validada e formatada de forma consistente. O Formatador de Schema GraphQL analisa seu schema com o mesmo parser de referência que o próprio GraphQL usa, então um erro de sintaxe real é informado com a linha e a coluna exatas em vez de um palpite, e um schema válido é reimpresso com espaçamento limpo e uniforme.

Ele foi feito para os momentos em que um schema chega bagunçado: copiado de um pull request, extraído de documentação, gerado por um framework code-first ou entregue por um assistente de IA com indentação inconsistente. Cole, e receba de volta uma versão canônica.

Como usar

1. Cole seu SDL do GraphQL na caixa de entrada, ou envie um arquivo .graphql, .gql ou .sdl.
2. Opcionalmente, defina a Largura da Indentação (2 ou 4 espaços) e ative Ordenar Types e Campos em Ordem Alfabética.
3. Copie o resultado formatado ou baixe-o como schema.graphql.

A formatação é executada automaticamente enquanto você digita ou altera uma opção.

O que ele faz

• Validação real. Seu schema é analisado com o graphql-js, a implementação de referência da especificação do GraphQL — o mesmo parser por trás de ferramentas como o Apollo Server e o GraphQL Code Generator. Um schema malformado (dois-pontos ausente, chave não fechada, token desconhecido) retorna a mensagem de erro exata do parser, com a linha e a coluna onde o problema aconteceu, em vez de produzir uma saída confusa silenciosamente.
• Indentação consistente. Escolha 2 ou 4 espaços; todo bloco — type, interface, input, enum, schema e descrições de múltiplas linhas — é reindentado de forma uniforme.
• Descrições preservadas. Descrições de uma linha ("...") e em bloco ("""...""") permanecem associadas ao type ou campo que documentam.
• Ordenação alfabética opcional. Quando ativada, as definições de nível superior são agrupadas por tipo (scalars, enums, interfaces, unions, object types, inputs, directives — o bloco schema { ... } sempre fica primeiro) e ordenadas por nome dentro de cada grupo; campos dentro dos corpos de type/interface/input e valores dentro dos corpos de enum também são ordenados em ordem alfabética. A ordem dos membros de uma union não é alterada, pois ela pode ter significado (um type preferencial listado primeiro).

Privacidade

Tudo acontece do lado do cliente, no seu navegador. Seu schema nunca é enviado a um servidor.

Ele preserva comentários #?

Não. O lexer do próprio GraphQL trata comentários no estilo # como irrelevantes e os descarta antes da análise — eles não fazem parte da AST do schema, então nenhum formatador construído sobre o parser de referência consegue devolvê-los intactos. Descrições em string ("..." e """..."""), que de fato fazem parte do schema, são preservadas exatamente.

Ele valida referências entre types?

Ele verifica a sintaxe — se o SDL é um GraphQL válido — e não a semântica completa do schema (uma referência de type não resolvida, ou uma directive usada em um lugar onde não foi declarada). Para validar nesse nível, construa o schema com uma biblioteca de servidor GraphQL.

Posso formatar um schema federado ou com vários arquivos inteiro?

Cole todos eles como um único documento combinado — definições extend type, extend interface e extend schema são suportadas e formatadas como qualquer outra definição.

O que exatamente o "Ordenar Alfabeticamente" reordena?

Duas coisas independentes: a ordem das definições de nível superior (agrupadas por tipo e depois por nome) e a ordem dos campos/valores de enum dentro de cada definição. Ele nunca renomeia nada nem altera um type ou argumento.