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

title: initializeGT
description: Configurez la bibliothèque gt-node de General Translation une seule fois au démarrage du serveur. Référence de l’API pour initializeGT.

---

Configure General Translation pour une utilisation dans l’environnement d’exécution Node.js. Appelez `initializeGT` une seule fois, avant toute autre fonction de traduction, afin de configurer les paramètres régionaux, les identifiants et la livraison des traductions.

## Vue d’ensemble [#overview]

Appelez `initializeGT` au début du fichier d’entrée de votre serveur. Il ne lit automatiquement ni vos variables d’environnement ni vos fichiers de configuration — fournissez explicitement chaque valeur. Consultez la [référence de configuration](/docs/node/reference/config) pour obtenir la liste complète des options.

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

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

Signature :

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

*Remarque : `initializeGT` doit être appelé avant d'utiliser [`withGT`](/docs/node/reference/functions/with-gt), [`getGT`](/docs/node/reference/functions/get-gt), [`getMessages`](/docs/node/reference/functions/get-messages) ou toute autre fonction de traduction. Les appeler d'abord provoque une erreur.*

## Fonctionnement [#how-it-works]

* **Configuration unique.** Appelez `initializeGT` exactement une fois lors de l’initialisation du serveur. Cela configure les paramètres régionaux, le cache de traduction et le stockage du paramètre régional pour chaque requête.
* **Mode de livraison.** Fournissez `projectId` pour charger les traductions depuis le CDN de General Translation, ou [`loadTranslations`](/docs/react/reference/functions/load-translations) pour utiliser votre propre source. Pour la traduction à la demande en développement, fournissez également `devApiKey`.
* **Synchrone.** L’appel renvoie immédiatement, sans attendre de requêtes réseau.

## Paramètres [#parameters]

| Paramètre           | Description                                                                                    | Type                 | Facultatif | Par défaut |
| ------------------- | ---------------------------------------------------------------------------------------------- | -------------------- | ---------- | ---------- |
| [`config`](#config) | Objet de configuration. Consultez la [référence de configuration](/docs/node/reference/config). | `InitializeGTParams` | Non        | —          |

### `config` [#config]

**Type** `InitializeGTParams` · **Obligatoire**

Objet combinant des options de paramètre régional, d’authentification, de cache et de dictionnaire. L’objet est obligatoire, mais chacun de ses champs est facultatif. Chaque champ est documenté dans la [référence de configuration](/docs/node/reference/config). Champs couramment utilisés :

* `defaultLocale` — paramètre régional source et de secours (par défaut `'en'`).
* `locales` — paramètres régionaux cibles pris en charge.
* `projectId` — ID du projet ; active le loader CDN lorsqu’il est renseigné.
* `devApiKey` — clé API de développement pour la traduction à la demande.
* `loadTranslations` — loader personnalisé renvoyant les traductions pour un paramètre régional.
* `customMapping` — alias de paramètres régionaux et redéfinitions de propriétés.

## Valeur de retour [#returns]

**Type** `void`

## Exemples [#examples]

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

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

```ts title="server.js"
// Avec un translation loader personnalisé
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();
  },
});
```

## Remarques [#notes]

* `initializeGT` doit être appelé une seule fois avant l’exécution de toute fonction de traduction.
* Si vous utilisez les services cloud de General Translation, fournissez `projectId` ; pour le développement, fournissez aussi `devApiKey`.
* L’option `loadTranslations` vous permet d’utiliser votre propre source de traductions au lieu du CDN de General Translation.