Vai al contenuto

Formattatore GraphQL

GraphQL Formatter

Formatta query e SDL, valida un documento rispetto a uno schema e stampa il tipo a cui si risolve.

Ristampa un documento GraphQL nello stile convenzionale: un campo per riga, argomenti spaziati, indentazione secondo la profondità della selezione. Analizza tutta la grammatica di ottobre 2021, quindi un file di schema con direttive, interfacce e unioni passa con la stessa facilità di una query.

🔒 Funziona interamente nel tuo browsergraphqlformatschema

GraphQL in ingresso

Formattato

Flusso di token

identico all’ingresso

Analizza tutta la grammatica di ottobre 2021 — operazioni, frammenti e l’intero linguaggio del sistema di tipi — e la ristampa nello stile consueto. I commenti restano, le virgole vengono normalizzate via (sono token ignorati) e a ogni passaggio si verifica che l’output porti esattamente i token dell’ingresso.

Come si usa

  1. Incollare il documento o aprire un file

    Una query, una mutation, un frammento o un intero schema `.graphql`. Vanno bene sia le operazioni anonime sia quelle con nome.

  2. Controllare la riga sul flusso di token

    Dopo ogni esecuzione il formattatore ritokenizza la propria uscita e la confronta con l’input. L’indicatore dice «identico all’input» quando si è mosso solo il layout — e grida se non è così.

  3. Copiare o scaricare il risultato

    Lo scaricamento è un file `.graphql` con il tipo MIME giusto, pronto da mettere in una cartella di schemi.

Domande frequenti

Dove sono finite le mie virgole?

GraphQL tratta le virgole come token ignorati: sono spazi bianchi con una forma. Il formattatore le normalizza via perché lo stile convenzionale non ne ha, e togliendole non si perde nessun significato.

I commenti vengono conservati?

Sì, e il confronto dopo ogni esecuzione controlla anche quello: i token di commento nell’uscita devono coincidere con quelli entrati. Un formattatore che toglie la riga `# deprecated` sopra un campo ha rotto il documento per chi lo leggerà dopo.

Convalida la query rispetto a uno schema?

No. Controlla la grammatica, non il significato: una query che chiede un campo che non esiste è sintatticamente perfetta e si formatta bene. La convalida ha bisogno dello schema, che questa pagina non ha mai.

Può ricevere da

Dopo

Questi accettano ciò che produce questo strumento, così il risultato può passare direttamente.