# node: getTranslations
URL: https://generaltranslation.com/fr/docs/node/api/get-translations.mdx
---
title: getTranslations
description: Référence de l’API pour la fonction getTranslations de traduction du dictionnaire
---

## Vue d’ensemble

`getTranslations` renvoie une fonction de traduction `t` qui récupère des entrées depuis un [dictionnaire](/docs/next/guides/dictionaries).
Utilisez-la pour traduire des chaînes prédéfinies à partir de leur clé de dictionnaire.

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

const t = await getTranslations();
t('greeting.hello'); // "Bonjour !"
```

<Callout>
  **Contexte de requête requis :**
  `getTranslations` doit être appelé dans un callback [`withGT`](/docs/node/api/with-gt) pour savoir quel paramètre régional utiliser.
</Callout>

## Référence

### Paramètres

Aucun.

### Retourne

Une promesse qui renvoie une fonction de traduction `t` :

```ts
Promise<TFunctionType>
```

La fonction `t` accepte une clé de dictionnaire et des options d’interpolation facultatives :

| Nom        | Type                           | Description                                                        |
| ---------- | ------------------------------ | ------------------------------------------------------------------ |
| `id`       | `string`                       | Le chemin, séparé par des points, vers une entrée du dictionnaire. |
| `options?` | `DictionaryTranslationOptions` | Variables d’interpolation.                                         |

**Renvoie :** `string` — le texte traduit (ou, à défaut, le texte dans la langue source).

Si la clé n’existe pas dans le dictionnaire source, `t()` génère une erreur.
Si la clé existe dans le dictionnaire source mais n’a pas de traduction pour le paramètre régional actuel, `t()` renvoie le texte source.

### `t.obj()`

Renvoie tout un sous-arbre du dictionnaire sous forme d’objet, plutôt qu’une seule chaîne de caractères.

```ts
t.obj(id: string): DictionaryObjectTranslation
```

| Nom  | Type     | Description                                                             |
| ---- | -------- | ----------------------------------------------------------------------- |
| `id` | `string` | Le chemin, séparé par des points, vers un sous-arbre du `dictionnaire`. |

**Renvoie :** Un objet imbriqué correspondant à la structure du `dictionnaire`, avec des valeurs traduites lorsqu’elles sont disponibles et, sinon, les valeurs en langue source.

***

## Configuration

### Automatique (recommandé)

Créez un fichier `dictionary.json` à la racine du projet :

```json title="dictionary.json"
{
  "greeting": {
    "hello": "Hello!"
  },
  "user": {
    "welcome": "Welcome, {name}!"
  }
}
```

Lorsque vous exécutez `npx gtx translate`, la CLI détecte automatiquement `dictionary.json` et le traduit pour les paramètres régionaux que vous avez configurés.

Initialisez ensuite GT avec le dictionnaire :

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  defaultLocale: 'en-US',
  locales: ['en-US', 'es', 'fr'],
});
```

### Chargeur personnalisé de dictionnaire

Si vous gérez vos propres dictionnaires de traduction, passez une fonction `loadDictionary` à [`initializeGT`](/docs/node/api/initialize-gt) :

```ts
import { initializeGT } from 'gt-node';
import dictionary from './dictionary.json';

initializeGT({
  dictionary,
  loadDictionary: async (locale) => {
    const dict = await import(`./locales/${locale}.json`);
    return dict.default;
  },
});
```

Les traductions chargées via `loadDictionary` priment sur celles générées par GT.

***

## Exemples

### Utilisation de base

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

const t = await getTranslations();
t('greeting.hello'); // "Bonjour !"
```

### Interpolation de variables

```ts
const t = await getTranslations();
t('user.welcome', { name: 'Alice' }); // "Bienvenue, Alice !"
```

### Recherche d’objet avec `t.obj()`

```ts
const t = await getTranslations();

const errors = t.obj('errors');
// { notFound: "Page not found", unauthorized: "Access denied" }
```

***

## Remarques

* `getTranslations` est l’équivalent fondé sur un dictionnaire de [`getMessages`](/docs/node/api/get-messages), utilisé pour les chaînes `msg()` en ligne.
* Pour l’équivalent dans Next.js, voir [`getTranslations` dans gt-next](/docs/next/api/dictionary/get-translations).