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

title: getGT
description: Obtenez une fonction de General Translation pour le paramètre régional de la requête en cours afin de traduire des chaînes inline. Référence de l’API pour getGT.

---

Une fonction asynchrone qui renvoie une fonction de traduction pour le paramètre régional de la requête en cours. Elle utilise les traductions enregistrées au build par le compilateur General Translation et se rabat sur la chaîne source lorsqu’aucune traduction n’est trouvée.

## Vue d’ensemble [#overview]

Utilisez `await` avec `getGT` dans un niveau [`withGT`](/docs/node/reference/functions/with-gt) pour obtenir une fonction synchrone `gt(message, options?)`, puis traduisez des chaînes avec celle-ci.

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

const gt = await getGT();
const greeting = gt('Hello, world!');
```

Signature :

```ts
getGT(): Promise<GTFunctionType>

type GTFunctionType = (message: string, options?: GTTranslationOptions) => string;
```

*Remarque : `getGT` doit être appelé dans un callback [`withGT`](/docs/node/reference/functions/with-gt) afin qu’il puisse savoir quel paramètre régional utiliser. Il accepte également un argument interne `_messages`, utilisé par le compilateur pour le rechargement à chaud en développement ; vous ne le transmettez pas directement.*

## Fonctionnement [#how-it-works]

* **Traductions build.** `getGT` renvoie une fonction de traduction build. Les chaînes sont traduites pendant le processus de CD avant le déploiement, de sorte qu&#39;en production, les requêtes utilisent des traductions mises en cache sans aller-retour réseau.
* **Développement.** En développement, les traductions se font à la demande et nécessitent une clé API de développement.
* **Contenu de secours.** Si aucune traduction n&#39;est trouvée, la chaîne source d&#39;origine (interpolée) est renvoyée.
* **Interpolation.** Utilisez des espaces réservés `{variableName}` dans la chaîne et transmettez les valeurs dans l&#39;objet d&#39;options. `gt-node` prend en charge le [format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/) pour le formatage avancé.

## Paramètres [#parameters]

`getGT` ne prend aucun paramètre. La fonction `gt` renvoyée accepte :

| Paramètre             | Description                                         | Type                   | Facultatif | Par défaut |
| --------------------- | --------------------------------------------------- | ---------------------- | ---------- | ---------- |
| [`message`](#message) | La chaîne à traduire.                               | `string`               | Non        | —          |
| [`options`](#options) | Variables d’interpolation et options de traduction. | `GTTranslationOptions` | Oui        | `{}`       |

### `message` [#message]

**Type** `string` · **Obligatoire**

La chaîne à traduire. Elle peut contenir des espaces réservés `{variable}` pour l’interpolation ICU.

### `options` [#options]

**Type** `GTTranslationOptions` · **Facultatif**

Options de traduction et variables d’interpolation :

* `$context?: string` — contexte supplémentaire pour aider à désambiguïser les traductions.
* `$id?: string` — ID personnalisé pour l’entrée de traduction.
* `$locale?: string` — remplace le paramètre régional de la requête pour cet appel.
* `$format?: string` — le format du message. Valeur par défaut : `'ICU'`.
* `$maxChars?: number` — nombre maximal de caractères pour la traduction.
* `$requiresReview?: boolean` — indique si la traduction doit être approuvée avant d’être utilisée.
* Toutes les autres keys sont traitées comme des valeurs à interpoler dans la chaîne à l’aide de la syntaxe `{key}`.

## Retourne [#returns]

**Type** `Promise<GTFunctionType>`

Renvoie la fonction de traduction `gt`. L’appel à `gt(message, options?)` retourne la chaîne traduite, ou la chaîne d’origine (interpolée) si aucune traduction n’est trouvée.

## Exemples [#examples]

```ts title="handler.js"
// Traduction simple
import { withGT, getGT } from 'gt-node';

function handleRequest(locale) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, world!');
  });
}
```

```ts title="handler.js"
// Avec des variables — utilisez {name} dans la chaîne et passez les valeurs dans l'objet options
import { withGT, getGT } from 'gt-node';

function handleGreeting(locale, name) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, {name}!', { name });
  });
}
```

```ts title="handler.js"
// Avec le format de message ICU
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

## Remarques [#notes]

* `getGT` renvoie une fonction de traduction build ; les chaînes sont traduites pendant le processus de CD avant le déploiement.
* En développement, les traductions se font à la demande et nécessitent une clé API de développement.
* Si aucune traduction n’est trouvée, la chaîne d’origine est renvoyée comme contenu de secours.
* Pour les chaînes connues uniquement au runtime, utilisez [`tx`](/docs/node/reference/functions/tx) ; pour les chaînes enregistrées au niveau du module, utilisez [`msg`](/docs/node/reference/functions/msg) avec [`getMessages`](/docs/node/reference/functions/get-messages).