# gt-node: General Translation Node.js SDK: Traduire des chaînes
URL: https://generaltranslation.com/fr/docs/node/guides/translating-strings.mdx
---

title: Traduire des chaînes
description: Comment traduire les chaînes du gestionnaire, les messages enregistrés et le contenu dynamique avec General Translation dans gt-node.
related:
  links:
    - /docs/node/guides/detecting-locale
    - /docs/node/guides/storing-translations
    - /docs/node/guides/configuring

---

`gt-node` propose trois façons de traduire une chaîne. Le choix dépend de l’endroit où se trouve la chaîne et du fait qu’elle soit connue à l’avance ou non.

*Remarque : les trois s’exécutent dans un contexte [`withGT`](/docs/node/guides/detecting-locale), afin de connaître le paramètre régional de la requête.*

## Traduire les chaînes d’un gestionnaire avec `getGT` [#get-gt]

Pour les chaînes écrites directement dans un gestionnaire, utilisez [`getGT`](/docs/node/reference/functions/get-gt) avec `await` pour obtenir une fonction de traduction, puis appelez-la. Interpolez les valeurs à l’aide de placeholder ICU.

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

app.get('/api/greeting', async (req, res) => {
  const gt = await getGT();
  res.json({
    message: gt('Hello, world!'),
    welcome: gt('Welcome, {name}!', { name: 'Alice' }),
  });
});
```

C’est le choix par défaut pour les chaînes utilisées ponctuellement. Ajoutez `$context` pour lever l’ambiguïté d’un terme.

## Réutiliser des messages enregistrés avec `msg` [#msg]

Pour les chaînes définies en dehors d’un gestionnaire — constantes partagées, messages d’erreur, énumérations — enregistrez-les avec [`msg`](/docs/node/reference/functions/msg) au niveau du module, puis récupérez-les avec [`getMessages`](/docs/node/reference/functions/get-messages).

```ts
import { msg, getMessages } from 'gt-node';

const NOT_FOUND = msg('Resource not found.');

app.use(async (req, res) => {
  const m = await getMessages();
  res.status(404).json({ error: m(NOT_FOUND) });
});
```

## Traduire le contenu dynamique avec `tx` [#tx]

Pour le contenu qui n’est pas connu à l’avance et n’est pas pré-généré, utilisez [`tx`](/docs/node/reference/functions/tx) pour traduire à l’exécution. Il effectue une requête réseau en cas de cache miss, donc réservez-le aux chaînes réellement dynamiques.

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

const translated = await tx(`Status: ${status}`);
```

*Remarque : `tx` n’utilise pas de placeholders ICU — intégrez les valeurs avec un littéral de gabarit avant de l’appeler.*

## Choisissez une approche [#choose]

* Chaînes ponctuelles dans un gestionnaire → `getGT`.
* Constantes et erreurs partagées → `msg` avec `getMessages`.
* Contenu dynamique et imprévisible → `tx`.
* Textes centralisés basés sur des clés → un dictionnaire avec [`getTranslations`](/docs/node/reference/functions/get-translations).
## Next steps

- /docs/node/guides/detecting-locale
- /docs/node/guides/storing-translations
- /docs/node/guides/configuring