Pular para o conteúdo

Formatador de GraphQL

GraphQL Formatter

Formata queries e SDL, valida um documento contra um schema e imprime o tipo em que ele resolve.

Reimprime um documento GraphQL no estilo convencional: um campo por linha, argumentos com espaços, indentação pela profundidade da seleção. Ele analisa a gramática completa de outubro de 2021, então um arquivo de esquema com diretivas, interfaces e uniões passa com a mesma facilidade que uma consulta.

🔒 Roda inteiramente no seu navegadorgraphqlformatschema

GraphQL de entrada

Formatado

Fluxo de tokens

idêntico à entrada

Analisa a gramática completa de outubro de 2021 — operações, fragmentos e toda a linguagem do sistema de tipos — e reimprime no estilo de sempre. Os comentários ficam, as vírgulas são normalizadas e somem (são tokens ignorados), e a cada passada confere-se que a saída carrega exatamente os tokens da entrada.

Como usar

  1. Cole o documento ou abra um arquivo

    Uma query, uma mutation, um fragment ou um esquema `.graphql` inteiro. Operações anônimas e nomeadas servem igualmente.

  2. Confira a linha do fluxo de tokens

    Depois de cada execução, o formatador retokeniza a própria saída e compara com a entrada. A estatística diz “idêntico à entrada” quando só o layout se moveu — e grita se não foi o caso.

  3. Copie ou baixe o resultado

    O download é um arquivo `.graphql` com o tipo MIME certo, pronto para soltar em um diretório de esquemas.

Perguntas frequentes

Para onde foram minhas vírgulas?

GraphQL trata vírgulas como tokens ignorados: são espaço em branco com formato. O formatador as normaliza removendo-as porque o estilo convencional não tem nenhuma, e nenhum significado se perde ao tirá-las.

Os comentários são mantidos?

Sim, e a comparação depois de cada execução confere isso também: os tokens de comentário da saída têm de bater com os que entraram. Um formatador que descarta a linha `# deprecated` acima de um campo quebrou o documento, do ponto de vista do próximo leitor.

Ele valida a consulta contra um esquema?

Não. Confere a gramática, não o significado: uma consulta que pede um campo que não existe é sintaticamente perfeita e formata bem. Validação precisa do esquema, que esta página nunca tem.

Pode receber de

Em seguida

Estas aceitam o que esta ferramenta produz, então o resultado pode ir direto.