# gt-node: General Translation Node.js SDK: initializeGT
URL: https://generaltranslation.com/fr/docs/node/reference/functions/initialize-gt.mdx
Docs index: https://generaltranslation.com/llms.txt
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 lit les identifiants de secours dans `GT_PROJECT_ID`, `GT_API_KEY` et `GT_DEV_API_KEY`, mais il ne lit pas automatiquement `gt.config.json`. 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'],
});
```

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.
* **Priorité des informations d’identification.** Les valeurs explicites non vides de `projectId`, `apiKey` et `devApiKey` sont prioritaires. Les valeurs omises ou vides utilisent à la place leurs variables d’environnement correspondantes.
* **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é.
* `apiKey` — clé API de production.
* `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'],
  // Les identifiants sont lus depuis GT_PROJECT_ID, GT_API_KEY et GT_DEV_API_KEY.
});
```

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

## Historique des versions [#version-history]

| Version         | Modifications                                                                                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gt-node` 1.0.8 | Ajout de solutions de secours via les variables d’environnement `GT_PROJECT_ID`, `GT_API_KEY` et `GT_DEV_API_KEY`. Les paramètres explicites non vides restent prioritaires. |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.