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

title: tx
description: Traduire une chaîne à la demande au moment de l’exécution avec General Translation. Référence de l’API pour tx.

---

Traduit des chaînes au moment de l’exécution. Contrairement à [`getGT`](/docs/node/reference/functions/get-gt), qui renvoie des traductions build-time, `tx` envoie du contenu pour une traduction à la demande. Il peut donc traduire des chaînes qui ne sont connues qu’au moment de l’exécution.

## Vue d’ensemble [#overview]

À l’intérieur d’un niveau [`withGT`](/docs/node/reference/functions/with-gt), utilisez `await` avec `tx` en lui passant la chaîne à traduire. Cela renvoie la chaîne traduite.

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

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

Signature :

```ts
tx(content: string, options?: RuntimeTranslationOptions): Promise<string>
```

*Remarque : `tx` effectue la traduction à la demande, ce qui entraîne une requête réseau et un délai supplémentaire par rapport à une traduction au moment du build. Utilisez [`getGT`](/docs/node/reference/functions/get-gt) pour les chaînes connues au moment du build, et `tx` uniquement lorsque le contenu est dynamique ou n’est pas connu à l’avance.*

## Fonctionnement [#how-it-works]

* **Traduction à l’exécution.** Les traductions s’effectuent à l’exécution via une requête réseau lorsqu’il n’y a pas d’entrée en cache ; il y a donc un délai par rapport à une traduction au moment du build. Réservez `tx` au contenu dynamique.
* **Pas d’interpolation ICU.** Contrairement à [`getGT`](/docs/node/reference/functions/get-gt), `tx` n’interpole pas les placeholders `{variable}` — il traite la chaîne comme du texte brut. Intégrez les variables avec des littéraux de gabarit JavaScript afin que leurs valeurs soient incluses dans le contenu envoyé pour traduction.
* **Contenu de secours.** Renvoie la chaîne d’origine si aucune traduction n’est nécessaire.

## Paramètres [#parameters]

| Paramètre             | Description                                                        | Type                        | Facultatif | Par défaut |
| --------------------- | ------------------------------------------------------------------ | --------------------------- | ---------- | ---------- |
| [`content`](#content) | La chaîne de caractères à traduire.                                | `string`                    | Non        | —          |
| [`options`](#options) | Options permettant de personnaliser le comportement de traduction. | `RuntimeTranslationOptions` | Oui        | —          |

### `content` [#content]

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

La chaîne à traduire. Intégrez des valeurs dynamiques à l’aide de littéraux de gabarit plutôt que de placeholder `{variable}`.

### `options` [#options]

**Type** `RuntimeTranslationOptions` · **Facultatif**

Options permettant de personnaliser la traduction à l’exécution :

* `$context?: string` — contexte supplémentaire pour aider à désambiguïser les traductions.
* `$locale?: string` — remplace le paramètre régional défini par [`withGT`](/docs/node/reference/functions/with-gt).
* `$maxChars?: number` — nombre maximal de caractères pour la traduction.
* `$requiresReview?: boolean` — indique si la traduction doit être approuvée avant utilisation.

*Remarque : `RuntimeTranslationOptions` ressemble aux options inline de [`getGT`](/docs/node/reference/functions/get-gt), mais sans `$id`, et son `$format` utilise par défaut plain-string (non-ICU) plutôt qu’ICU.*

## Renvoie [#returns]

**Type** `Promise<string>`

Se résout avec la chaîne traduite, ou avec la chaîne d’origine si aucune traduction n’est nécessaire.

## Exemples [#examples]

```ts title="handler.js"
// Utilisation de base
import { withGT, tx } from 'gt-node';

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

```ts title="handler.js"
// Avec des variables — incorporez les valeurs avec des littéraux de gabarit, pas des {placeholders}
import { withGT, tx } from 'gt-node';

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

```ts title="handler.js"
// Avec contexte pour lever l'ambiguïté des traductions
const translated = await tx('Spring', {
  $context: 'the season, not a coil',
});
```

```ts title="handler.js"
// Spécifier un paramètre régional — remplacer le paramètre régional de withGT
const translated = await tx('Hello, world!', { $locale: 'fr' });
```

## Notes [#notes]

* `tx` est asynchrone et renvoie une promesse. Utilisez toujours `await` sur le résultat.
* Les traductions se font au runtime via une requête réseau ; elles entraînent donc un délai par rapport aux traductions au moment du build.
* `tx` ne prend pas en charge l’interpolation ICU `{variable}`. Utilisez des littéraux de gabarit pour y intégrer des variables.
* Pour les chaînes statiques avec interpolation de variables ICU, utilisez [`getGT`](/docs/node/reference/functions/get-gt) ou [`msg`](/docs/node/reference/functions/msg) avec [`getMessages`](/docs/node/reference/functions/get-messages).