# General Translation React SDKs (gt-react, gt-next): tx
URL: https://generaltranslation.com/fr/docs/react/nextjs/reference/functions/tx.mdx
---

title: tx
description: Traduisez les chaînes à la requête dans le code serveur de Next.js App Router avec General Translation. Référence de l’API pour tx.

---

La fonction `tx` traduit une chaîne à la requête via l’API de General Translation. Utilisez-la pour le contenu dynamique qui n’est pas connu au build ; utilisez [`getGT`](/docs/react/nextjs/reference/functions/get-gt) pour les chaînes source statiques.

`tx` est uniquement disponible côté serveur et ne fonctionne pas avec le Pages Router.

## Aperçu [#overview]

```tsx
import { tx } from 'gt-next/server';

const translated = await tx('A message loaded at request time');
```

## Paramètres [#parameters]

| Paramètre | Description                                                                                  | Type     | Facultatif | Par défaut |
| --------- | -------------------------------------------------------------------------------------------- | -------- | ---------- | ---------- |
| `message` | Chaîne à traduire.                                                                           | `string` | Non        | —          |
| `options` | Paramètre régional cible, contexte, format, limite de longueur et variables d’interpolation. | `object` | Oui        | `{}`       |

`options` accepte `$locale`, `$context`, `$maxChars` et `$format`. Transmettez les variables d’interpolation sous forme de clés de premier niveau.

## Valeur de retour [#returns]

**Type** `Promise<string>`

Une promesse résolue avec la chaîne traduite, ou avec la chaîne source lorsque la traduction est désactivée ou non nécessaire.

## Exemple [#example]

```tsx title="app/notes/[id]/page.tsx"
import { tx } from 'gt-next/server';

export default async function NotePage({ params }) {
  const note = await loadNote((await params).id);
  const translated = await tx(note, {
    $context: 'A user-created note',
  });
  return <p>{translated}</p>;
}
```