# node: getGT
URL: https://generaltranslation.com/fr/docs/node/api/get-gt.mdx
---
title: getGT
description: Référence de l’API pour la fonction de traduction de chaînes de caractères getGT
---

## Vue d’ensemble

La fonction `getGT` est une fonction asynchrone qui renvoie une fonction de traduction permettant de traduire des chaînes de caractères.
Elle récupère les traductions enregistrées au build par le compilateur GT.

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

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

<Callout>
  **Contexte de requête requis :**
  `getGT` 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.

### Renvoie

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

```ts
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Nom        | Type                       | Description                                                     |
| ---------- | -------------------------- | --------------------------------------------------------------- |
| `content`  | `string`                   | La chaîne de caractères à traduire.                             |
| `options?` | `InlineTranslationOptions` | Options de traduction facultatives (variables, contexte, etc.). |

La fonction `gt` renvoie la chaîne de caractères traduite, ou la chaîne d’origine si aucune traduction n’est trouvée.


#### `InlineTranslationOptions`

| Propriété    | Type     | Description                                                                                    |
| ------------ | -------- | ---------------------------------------------------------------------------------------------- |
| `$context?`  | `string` | Contexte supplémentaire pour lever les ambiguïtés de traduction.                               |
| `$id?`       | `string` | ID personnalisé pour la voix de traduction.                                                    |
| `$maxChars?` | `number` | Nombre maximal de caractères pour la traduction.                                               |
| Autres clés  | `any`    | Valeurs de variables à interpoler dans la chaîne de caractères à l’aide de la syntaxe `{key}`. |

***

## Exemples

### Traduction simple

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

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


### Avec des variables

Utilisez la syntaxe `{variableName}` dans la chaîne de caractères et passez les valeurs dans l’objet `options` :

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

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


### Avec le format des messages ICU

`gt-node` prend en charge le format des messages ICU pour une mise en forme avancée :

```js title="handler.js"
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

***


## Remarques

* `getGT` renvoie une fonction de traduction **de build**. Les chaînes de caractères sont traduites pendant le processus de CD, avant le déploiement.
* En développement, les traductions s’effectuent à la demande (nécessite une clé API de développement).
* Si aucune traduction n’est trouvée, la chaîne de caractères d’origine est renvoyée par défaut.

## Étapes suivantes

* Voir [`getMessages`](/docs/node/api/get-messages) pour récupérer les messages préenregistrés.
* Voir [`withGT`](/docs/node/api/with-gt) pour configurer le contexte du paramètre régional.