# node: tx
URL: https://generaltranslation.com/fr/docs/node/api/strings/tx.mdx
---
title: tx
description: Référence API de la fonction tx de traduction de chaînes Runtime
---

## Vue d’ensemble

La fonction `tx` traduit les chaînes de caractères en Runtime. Contrairement à [`getGT`](/docs/node/api/get-gt), qui résout les traductions au moment du build, `tx` envoie le contenu pour une traduction à la demande — elle peut donc traduire des chaînes de caractères qui ne sont connues qu’en Runtime.

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

const translated = await tx('Hello, world!');
```

<Callout>
  **Traduction Runtime :**
  `tx` effectue la traduction à la demande, ce qui implique une requête réseau et un délai supplémentaire par rapport à une traduction effectuée au build.
  Utilisez [`getGT`](/docs/node/api/get-gt) pour les chaînes de caractères connues au build, et réservez `tx` aux cas où le contenu est dynamique ou inconnu à l&#39;avance.
</Callout>

## Référence

### Paramètres

| Nom        | Type                                                                            | Description                                                        |
| ---------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `content`  | `string`                                                                        | La chaîne de caractères à traduire.                                |
| `options?` | [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) | Options permettant de personnaliser le comportement de traduction. |

### Renvoie

`Promise<string>` — la chaîne de caractères traduite, ou la chaîne source si aucune traduction n’est nécessaire.

***

## Exemples

### Utilisation de base

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

function handleRequest(locale) {
  return withGT(locale, async () => {
    return await tx('Processing complete');
  });
}
```

### Avec des variables

Comme `tx` traduit les chaînes de caractères au Runtime, intégrez directement les variables dans la chaîne de caractères à l’aide de littéraux de gabarit. Cela garantit que les valeurs des variables sont incluses dans le contenu envoyé pour traduction :

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

function handleStatus(locale, status) {
  return withGT(locale, async () => {
    return await tx(`Current status: ${status}`);
  });
}
```

<Callout type="warn">
  **`tx` n’interpole pas les espaces réservés `{variable}`.**
  Contrairement à [`getGT`](/docs/node/api/get-gt), qui utilise le format de message ICU (syntaxe `{name}`), `tx` traite la chaîne comme une simple chaîne de caractères.
  Utilisez les littéraux de gabarit JavaScript (`` `Hello, ${name}` ``) pour y inclure des variables.
</Callout>

### Avec un contexte

Ajoutez `$context` pour lever les ambiguïtés de traduction :

```js title="handler.js"
const translated = await tx('Spring', {
  $context: 'the season, not a coil',
});
```

### Indiquer un paramètre régional

Remplacez le paramètre régional défini par [`withGT`](/docs/node/api/with-gt) :

```js title="handler.js"
const translated = await tx('Hello, world!', { $locale: 'fr' });
```

***

## Remarques

* `tx` est asynchrone et renvoie une promesse. Utilisez toujours `await` pour attendre le résultat.
* Les traductions s’effectuent en Runtime via une requête réseau ; elles sont donc plus lentes que les traductions au build.
* `tx` ne prend **pas** en charge l’interpolation ICU `{variable}`. Utilisez des littéraux de gabarit pour y insérer des variables.
* Pour les chaînes de caractères statiques avec interpolation de variables ICU, utilisez [`getGT`](/docs/node/api/get-gt) ou [`msg`](/docs/node/api/strings/msg) / [`getMessages`](/docs/node/api/get-messages).

## Étapes suivantes

* Consultez [`getGT`](/docs/node/api/get-gt) pour la traduction de chaînes au build.
* Consultez [`RuntimeTranslationOptions`](/docs/next/api/types/runtime-translation-options) pour personnaliser le comportement de la traduction.
* Consultez [Approches de traduction de chaînes](/docs/node/guides/strings) pour comparer toutes les approches de traduction.