# node: initializeGT
URL: https://generaltranslation.com/it/docs/node/api/initialize-gt.mdx
---
title: initializeGT
description: Riferimento API della funzione di setup initializeGT
---

## Panoramica

La funzione `initializeGT` configura General Translation per l'uso in un ambiente runtime Node.js.
Deve essere chiamata una sola volta prima di usare qualsiasi funzione di traduzione.

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

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
  projectId: 'your-project-id',
});
```

<Callout type="warn">
  **Setup richiesto:**
  `initializeGT` deve essere chiamato prima di usare `withGT`, `getGT`, `getMessages` o qualsiasi altra funzione di traduzione.
  Chiamala una sola volta durante l&#39;inizializzazione del server (ad esempio, all&#39;inizio del file di ingresso).
</Callout>

## Riferimento

### Parametri

<TypeTable
  type={{
"defaultLocale?": {
  type: 'string',
  optional: true,
  default: "'en-US'",
},
"locales?": {
  type: 'string[]',
  optional: true,
},
"projectId?": {
  type: 'string',
  optional: true,
},
"devApiKey?": {
  type: 'string',
  optional: true,
},
"cacheUrl?": {
  type: 'string | null',
  optional: true,
},
"runtimeUrl?": {
  type: 'string | null',
  optional: true,
},
"loadTranslations?": {
  type: 'TranslationsLoader',
  optional: true,
},
"customMapping?": {
  type: 'Record<string, string | Partial<LocaleProperties>>',
  optional: true,
},
"enableI18n?": {
  type: 'boolean',
  optional: true,
},
"cacheExpiryTime?": {
  type: 'number',
  optional: true,
},
}}
/>

### Descrizione

| Prop               | Descrizione                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
| `defaultLocale`    | L&#39;impostazione regionale predefinita della tua applicazione. Il valore predefinito è `'en-US'`.                  |
| `locales`          | Un array di codici locale supportati dalla tua applicazione.                                                         |
| `projectId`        | L&#39;ID del tuo progetto General Translation, obbligatorio per i servizi di traduzione cloud.                       |
| `devApiKey`        | Chiave API per le traduzioni on-demand nell&#39;ambiente di sviluppo.                                                |
| `cacheUrl`         | URL del servizio di cache di GT. Imposta `null` per disattivarlo.                                                    |
| `runtimeUrl`       | URL del servizio di traduzione runtime di GT. Imposta `null` per disattivarlo.                                       |
| `loadTranslations` | Una funzione personalizzata per caricare le traduzioni da una tua sorgente.                                          |
| `customMapping`    | Una mappatura tra codici locale personalizzati e codici locale standard o proprietà dell&#39;impostazione regionale. |
| `enableI18n`       | Indica se abilitare le funzionalità i18n.                                                                            |
| `cacheExpiryTime`  | Tempo in millisecondi prima che le traduzioni memorizzate nella cache scadano.                                       |

### Restituisce

`void`

***

## Esempi

### Setup di base

```js title="server.js"
import { initializeGT } from 'gt-node';

initializeGT({
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr', 'ja'],
  projectId: process.env.GT_PROJECT_ID,
});
```


### Con un caricatore di traduzioni personalizzato

```js title="server.js"
import { initializeGT } from 'gt-node';

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

***


## Note

* `initializeGT` deve essere chiamata **una sola volta** prima di usare qualsiasi funzione di traduzione.
* Se utilizzi i servizi cloud di GT, specifica `projectId`. Per lo sviluppo, specifica anche `devApiKey`.
* L&#39;opzione `loadTranslations` ti consente di usare una sorgente di traduzione personalizzata invece della CDN di GT.

## Passaggi successivi

* Vedi [`withGT`](/docs/node/api/with-gt) per fornire il contesto dell&#39;impostazione regionale per ogni richiesta.
* Vedi [`getGT`](/docs/node/api/get-gt) e [`getMessages`](/docs/node/api/get-messages) per tradurre le stringhe.