Ir para o conteúdo

Formatador GraphQL

Formata ou minifica uma consulta, mutação, fragmento ou esquema GraphQL com indentação consistente.

Entrada
Saída

Formatador GraphQL

Cole uma consulta GraphQL, mutação, fragmento ou esquema e esta ferramenta reformata-o com indentação consistente e legível — ou minifica-o numa única linha para enviar pela rede. Compreende a estrutura partilhada por operações e definições de tipos, portanto uma consulta com conjuntos de seleção aninhados e um esquema cheio de blocos de tipos saem ambos com uma indentação bem apresentada, com campos, argumentos, diretivas e definições de variáveis no local certo.

Escolha a largura da indentação (2 espaços, 4 espaços ou uma tabulação) ou active "Minificar em vez de formatar" para eliminar espaços em branco e comentários até ao documento válido mais curto. "Ordenar campos alfabeticamente" reordena os campos dentro de cada conjunto de seleção ou bloco de tipos, útil para detetar um campo em falta ou duplicado numa consulta longa. "Colapsar variáveis da consulta numa única linha" decide se a lista de ` `$variável: Tipo` fica numa única linha ou se quebra para a sua própria linha indentada por variável, e "Linha vazia entre operações" adiciona espaçamento quando a entrada tem mais de uma consulta, mutação ou fragmento.

A ferramenta também valida enquanto formata: parênteses não correspondidos ou não fechados são comunicados em vez de supostos, e um conjunto de seleção que espalha um fragmento (`...MeuFragmento`) sem definição correspondente no texto colado fica assinalada. O total em direto relata quantas definições foram encontradas e quão profundamente a consulta se aninha — um sinal de aviso precoce para uma consulta que está a fazer demasiado fetch.

A formatação ocorre inteiramente no seu navegador — nada do que cola é enviado, o que é importante para esquemas e consultas que fazem referência a nomes de campos ou tipos internos. Copie o resultado, transfira-o como um ficheiro .txt ou envie o resultado de volta para a entrada para aplicar outra passagem com opções diferentes.

FAQ

Funciona com definições de esquema (SDL), não apenas consultas?
Sim. Blocos de tipo, interface, entrada, enumeração, união, escalar e esquema são todos formatados com a mesma indentação consistente das operações, e "Ordenar campos alfabeticamente" também se aplica aos seus campos.
O que acontece se minha consulta referencia um fragmento que não está na entrada?
A ferramenta ainda formata o resto do documento, mas a linha que espalha o fragmento em falta fica assinalada para que possa colar a sua definição ou corrigir uma gralha no seu nome.
Posso utilizar isto para reduzir uma consulta antes de a enviar pela rede?
Sim — active "Minificar em vez de formatar" para eliminar comentários e espaços em branco não essenciais até ao documento válido mais pequeno, mantendo a consulta semanticamente idêntica.
Os comentários são preservados?
Por predefinição, sim: comentários # e cadeias de descrição são mantidos na sua própria linha acima do que descrevem. Desative "Manter comentários" para eliminá-los, o que também ocorre automaticamente quando minifica.
A minha consulta ou esquema é enviado para algum lado?
Não. A formatação e minificação ocorrem inteiramente no seu navegador — nada do que cola sai do seu dispositivo.