# node: initializeGT
URL: https://generaltranslation.com/fr/docs/node/api/initialize-gt.mdx
---
title: initializeGT
description: Référence API de la fonction d’initialisation initializeGT
---

## Vue d’ensemble

La fonction `initializeGT` configure General Translation pour une utilisation dans un environnement d’exécution Node.js.
Elle doit être appelée une seule fois avant d’utiliser toute fonction de traduction.

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

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

<Callout type="warn">
  **Configuration requise :**
  `initializeGT` doit être appelé avant d’utiliser `withGT`, `getGT`, `getMessages` ou toute autre fonction de traduction.
  Appelez-le une seule fois lors de l’initialisation de votre serveur (par exemple, en haut de votre fichier d’entrée).
</Callout>

## Référence

### Paramètres

<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,
  },
}}
/>

### Description

| Prop               | Description                                                                                                                     |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `defaultLocale`    | Le paramètre régional par défaut de votre application. La valeur par défaut est `'en-US'`.                                      |
| `locales`          | Un tableau de codes de langue pris en charge par votre application.                                                             |
| `projectId`        | L’identifiant de votre projet General Translation, requis pour les services de traduction cloud.                                |
| `devApiKey`        | Clé API pour les traductions à la demande dans l’environnement de développement.                                                |
| `cacheUrl`         | URL du service de cache GT. Définissez-la sur `null` pour la désactiver.                                                        |
| `runtimeUrl`       | URL du service de traduction à l’exécution de GT. Définissez-la sur `null` pour la désactiver.                                  |
| `loadTranslations` | Une fonction personnalisée pour charger les traductions à partir de votre propre source.                                        |
| `customMapping`    | Correspondance entre des codes de langue personnalisés et des codes de langue standard ou des propriétés de paramètre régional. |
| `enableI18n`       | Indique si les fonctionnalités d’i18n sont activées.                                                                            |
| `cacheExpiryTime`  | Durée en millisecondes avant l’expiration des traductions mises en cache.                                                       |

### Renvoie

`void`

***

## Exemples

### Configuration de 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,
});
```


### Avec un chargeur de traductions personnalisé

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

***


## Remarques

* `initializeGT` doit être appelé **une seule fois** avant d’utiliser une quelconque fonction de traduction.
* Si vous utilisez les services cloud de GT, indiquez `projectId`. En développement, indiquez également `devApiKey`.
* L’option `loadTranslations` vous permet d’utiliser votre propre source de traductions au lieu du CDN de GT.

## Étapes suivantes

* Consultez [`withGT`](/docs/node/api/with-gt) pour définir le contexte de paramètre régional pour chaque requête.
* Consultez [`getGT`](/docs/node/api/get-gt) et [`getMessages`](/docs/node/api/get-messages) pour traduire des chaînes.