# 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. Non legge automaticamente né le variabili d'ambiente né i file di configurazione: passa ogni valore in modo esplicito. 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'],
  projectId: 'your-project-id',
});
```

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.
* **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 della 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.
* `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'],
  projectId: process.env.GT_PROJECT_ID,
});
```

```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();
  },
});
```

## Note [#notes]

* `initializeGT` deve essere chiamato una sola volta prima dell'esecuzione di qualsiasi funzione di traduzione.
* Se utilizzi i servizi cloud di General Translation, specifica `projectId`; per lo sviluppo, specifica anche `devApiKey`.
* L'opzione `loadTranslations` ti consente di usare una sorgente di traduzioni personalizzata invece della CDN di General Translation.