Come aprire file .GQL su Windows
Per aprire file .GQL su Windows, fai clic con il pulsante destro del mouse sul file .gql → Apri con → scegli un editor di testo/codice (qualsiasi editor in grado di aprire testo semplice).
Istruzioni passo passo
- Fai clic con il pulsante destro del mouse sul file .gql → Apri con → scegli un editor di testo/codice (qualsiasi editor in grado di aprire testo semplice).
- Se desideri il supporto della sintassi GraphQL, abilita un plug-in o un servizio linguistico GraphQL nel tuo editor e assicurati che sia configurato per riconoscere l'estensione .gql.
Problemi comuni
Il file si apre come testo normale senza evidenziazione o convalida GraphQL
Molti editor trattano .gql come testo generico a meno che gli strumenti del linguaggio GraphQL non siano installati o configurati per includere .gql come estensione riconosciuta.
- Installa/abilita gli strumenti del linguaggio GraphQL nel tuo editor (servizio/plugin del linguaggio GraphQL).
- Controlla le impostazioni dello strumento per le estensioni di file riconosciute e conferma che .gql sia incluso.
Gli strumenti di compilazione o generazione di codice ignorano i file .gql
Alcune toolchain sono configurate per scansionare solo determinate estensioni (spesso .graphql) per i documenti GraphQL.
- Controlla la configurazione del tuo strumento per i globi/estensioni dei documenti inclusi e aggiungi *.gql se necessario.
- Se lo strumento non può essere configurato, rinominare il file con un'estensione che esegue la scansione (comunemente .graphql) mantenendo il contenuto invariato.
Le richieste hanno esito negativo in fase di esecuzione perché il documento .gql non è valido per lo schema del server
Un file .gql può essere GraphQL sintatticamente valido ma fallire comunque rispetto a uno schema specifico (campi mancanti, argomenti errati o mancata corrispondenza del tipo di frammento).
- Convalidare il documento utilizzando strumenti compatibili con lo schema (servizio linguistico GraphQL/integrazione IDE) rispetto allo schema corretto.
- Aggiorna l'operazione/i frammenti in modo che corrispondano allo schema del server e riprova.
Nota di sicurezza
I file .gql sono documenti GraphQL di testo semplice, non eseguibili; tuttavia, possono comunque favorire l'accesso a dati sensibili se utilizzati come operazioni su un endpoint GraphQL (ad esempio, eseguendo accidentalmente il commit di query private o frammenti interni).