# gt-next: General Translation Next.js SDK: getMessages
URL: https://generaltranslation.com/fr/docs/next/api/strings/get-messages.mdx
---
title: getMessages
description: Référence de l’API pour la fonction getMessages() de traduction de chaînes
---

## Vue d’ensemble

La fonction `getMessages` est une fonction asynchrone qui permet de traduire les chaînes encodées par `msg` pendant la build.

```jsx
const m = await getMessages();

<p>{  m(encodedString)  }</p>;
```

<Callout>
  **Traduction à la build :**
  les traductions via `getMessages` ont lieu à la build, avant le déploiement de votre application.
  Vous pouvez transmettre des chaînes encodées par `msg`, et elles seront traduites dans la langue préférée de l’utilisateur.
</Callout>

## Référence

### Paramètres

Aucun

### Renvoie

Une promesse qui résout en une fonction de rappel, `m`, traduisant le contenu encodé fourni par `msg`.

```jsx
Promise<(encodedContent: string, options?: Record<string, any>) => string>
```

| Nom              | Type                  | Description                                                                         |
| ---------------- | --------------------- | ----------------------------------------------------------------------------------- |
| `encodedContent` | `string`              | Le contenu textuel encodé issu de `msg`, à traduire.                                |
| `options?`       | `Record<string, any>` | Paramètres facultatifs permettant de transmettre des variables à la chaîne encodée. |

***


## Fonctionnement

### Production

Pendant le processus de CD, tout contenu à l’intérieur d’une fonction `msg` est traduit avant le déploiement de votre application.
Cela garantit des temps de chargement rapides pour tous les paramètres régionaux, mais seul le contenu connu au build peut être traduit.

Une fois générées, les traductions sont soit (1) stockées dans le CDN, soit (2) intégrées à la sortie de build de votre application, selon votre configuration.
Elles sont ensuite servies à vos utilisateurs.
Si aucune traduction n’est trouvée, le contenu d’origine est utilisé.

Veillez à suivre le [guide de déploiement ici](/docs/next/tutorials/quickdeploy).

### Développement

Pendant le développement, la fonction `m` traduit le contenu à la demande.
C&#39;est utile pour prototyper l&#39;apparence de votre application dans différentes langues.
N&#39;oubliez pas d&#39;ajouter une clé d&#39;API de développement à votre environnement pour activer ce comportement.

Un délai se produira lors de la traduction à la demande en développement.
Cela ne se produira pas dans les builds de production, sauf si le contenu est explicitement traduit à la demande,
c.-à-d. avec [`tx`](/docs/next/api/strings/tx) ou [`<Tx>`](/docs/next/api/components/tx).

***

## Exemple

### Utilisation de base

Vous pouvez utiliser `getMessages` pour traduire des chaînes encodées par `msg`.

```javascript copy
import { msg, getMessages } from 'gt-next/server';

const encodedGreeting = msg('Hello, Alice!');

export default async function TranslateGreeting() {
  const m = await getMessages();

  return (
    <p>
      {m(encodedGreeting)}
    </p>
  );
}
```

Remarque : &quot;Alice&quot; sera traduit dans la langue préférée de l’utilisateur.


### Utiliser des variables [#variables]

Vous pouvez passer des variables à des chaînes encodées.

```javascript copy
import { msg, getMessages } from 'gt-next/server';

const encodedGreeting = msg('Hello, {name}!');

export default async function TranslateGreeting() {
  const m = await getMessages();

  return (
    <p>
      {m(encodedGreeting, { name: 'Bob' })} {/* Ceci affichera "Hello, Bob!" */}
    </p>
  );
}
```


### Les variables `msg` priment sur les variables `m`

Lorsque vous passez des variables à la fois à `msg` et à `m`, celles passées à `msg` priment sur celles passées à `m`.

```javascript copy
import { msg, getMessages } from 'gt-next/server';

const encodedGreeting = msg('Hello, {name}!', { name: 'Alice' });

export default async function TranslateGreeting() {
  const m = await getMessages();
  return (
    <p>
      {m(encodedGreeting, { name: 'Bob' })}
    </p>
  );
}
```

Remarque : cela affichera « Bonjour, Alice ! » - la variable n’est pas remplacée au moment du rendu.


### Utilisation du format de message ICU

`gt-next` prend en charge le format de message ICU, ce qui vous permet également de formater vos variables.

```javascript copy
import { msg, getMessages } from 'gt-next/server';

const encodedMessage = msg('There are {count, plural, =0 {no items} =1 {one item} other {{count} items}} in the cart', { count: 10 });

export default async function TranslateGreeting() {
  const m = await getMessages();
  return (
    <p>
      {m(encodedMessage)}
    </p>
  );
}
```

<Callout>
  Le format de message ICU est un moyen efficace de mettre en forme vos variables.
  Pour en savoir plus, consultez la [documentation sur le format de message ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Remarques

* La fonction `getMessages` s’exécute côté serveur et traduit les chaînes encodées par `msg`.
* La traduction des chaînes avec `getMessages` a lieu avant l’exécution, pendant le processus de build (sauf en développement).

## Étapes suivantes

* Consultez [`useMessages`](/docs/next/api/strings/use-messages) pour traduire côté client des chaînes encodées à la build.
* Consultez [`msg`](/docs/next/api/strings/msg) pour encoder des chaînes à traduire.
* Pour les traductions en exécution, consultez [`tx`](/docs/next/api/strings/tx) et [`<Tx>`](/docs/next/api/components/tx).