# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/it/docs/node/reference/functions/initialize-gt.mdx
---

title: initializeGT
description: Configura la libreria gt-node di General Translation una sola volta all'avvio del server. Riferimento API per initializeGT.

---

Configura General Translation per l'uso in un ambiente di runtime Node.js. Chiama `initializeGT` una sola volta, prima di qualsiasi altra funzione di traduzione, per configurare le impostazioni regionali, le credenziali e l'invio delle traduzioni.

## Panoramica [#overview]

Chiama `initializeGT` all'inizio del file di avvio del server. Legge i valori di fallback delle credenziali da `GT_PROJECT_ID`, `GT_API_KEY` e `GT_DEV_API_KEY`, ma non legge `gt.config.json` automaticamente. Consulta il [riferimento sulla configurazione](/docs/node/reference/config) per l'elenco completo delle opzioni.

```ts
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr'],
});
```

Firma:

```ts
initializeGT(config: InitializeGTParams): void
```

*Nota: `initializeGT` deve essere chiamata prima di usare [`withGT`](/docs/node/reference/functions/with-gt), [`getGT`](/docs/node/reference/functions/get-gt), [`getMessages`](/docs/node/reference/functions/get-messages) o qualsiasi altra funzione di traduzione. Se queste funzioni vengono chiamate prima, viene generato un errore.*

## Come funziona [#how-it-works]

* **Configurazione iniziale una tantum.** Chiama `initializeGT` esattamente una sola volta durante l'inizializzazione del server. Configura l'impostazione regionale, la cache delle traduzioni e la memorizzazione per richiesta dell'impostazione regionale.

- **Precedenza delle credenziali.** I valori espliciti e non vuoti di `projectId`, `apiKey` e `devApiKey` hanno la precedenza. I valori omessi o vuoti usano come fallback le rispettive variabili d'ambiente.

* **Modalità di caricamento.** Fornisci `projectId` per caricare le traduzioni dalla CDN di General Translation, oppure [`loadTranslations`](/docs/react/reference/functions/load-translations) per usare il tuo contenuto sorgente. Per la traduzione su richiesta in fase di sviluppo, fornisci anche `devApiKey`.
* **Sincrona.** La chiamata restituisce immediatamente e non attende richieste di rete.

## Parametri [#parameters]

| Parametro           | Descrizione                                                                                             | Tipo                 | Facoltativo | Predefinito |
| ------------------- | ------------------------------------------------------------------------------------------------------- | -------------------- | ----------- | ----------- |
| [`config`](#config) | Oggetto di configurazione. Consulta il [riferimento sulla configurazione](/docs/node/reference/config). | `InitializeGTParams` | No          | —           |

### `config` [#config]

**Tipo** `InitializeGTParams` · **Obbligatorio**

Un oggetto che raggruppa le opzioni di impostazione regionale, credenziali, cache e dizionario. L'oggetto è obbligatorio, ma tutti i suoi campi sono facoltativi. Ogni campo è documentato nel [riferimento sulla configurazione](/docs/node/reference/config). Campi usati più spesso:

* `defaultLocale` — impostazione regionale sorgente e di fallback (predefinita `'en'`).
* `locales` — impostazioni regionali di destinazione supportate.
* `projectId` — ID progetto; abilita il loader CDN se impostato.
* `apiKey` — chiave API di produzione.
* `devApiKey` — chiave API di sviluppo per la traduzione su richiesta.
* `loadTranslations` — loader personalizzato che restituisce le traduzioni per un'impostazione regionale.
* `customMapping` — alias delle impostazioni regionali e override delle proprietà.

## Restituisce [#returns]

**Tipo** `void`

## Esempi [#examples]

```ts title="server.js"
// Configurazione di base
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es', 'fr', 'ja'],
});
```

```ts title="server.js"
// Con un loader delle traduzioni personalizzato
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en',
  locales: ['en', 'es'],
  loadTranslations: async (locale) => {
    const res = await fetch(`https://my-api.com/translations/${locale}`);
    return res.json();
  },
});
```

## Cronologia versioni [#version-history]

| Versione        | Modifiche                                                                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gt-node` 1.0.8 | Aggiunti i fallback per le variabili d'ambiente `GT_PROJECT_ID`, `GT_API_KEY` e `GT_DEV_API_KEY`. I parametri espliciti non vuoti hanno comunque la precedenza. |