# gt-next: General Translation Next.js SDK: getMessages
URL: https://generaltranslation.com/it/docs/next/api/strings/get-messages.mdx
---
title: getMessages
description: Riferimento API per la funzione getMessages() di traduzione delle stringhe
---

## Panoramica

La funzione `getMessages` è una funzione asincrona che traduce le stringhe codificate da `msg` nella fase di build.

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

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

<Callout>
  **Traduzione in fase di build:**
  le traduzioni di `getMessages` avvengono in fase di build, prima della distribuzione della tua app.
  Puoi passare stringhe codificate da `msg`, che verranno tradotte nella lingua preferita dell&#39;utente.
</Callout>


## Riferimento

### Parametri

Nessuno

### Restituisce

Una promise di una funzione di callback, `m`, che traduce il contenuto codificato fornito da `msg`.

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

| Nome             | Tipo                  | Descrizione                                                          |
| ---------------- | --------------------- | -------------------------------------------------------------------- |
| `encodedContent` | `string`              | Il contenuto stringa codificato di `msg` da tradurre.                |
| `options?`       | `Record<string, any>` | Parametri facoltativi per passare variabili alla stringa codificata. |

***


## Comportamento

### Produzione

Durante il processo di CD, qualsiasi contenuto all&#39;interno di una funzione `msg` verrà tradotto prima che l&#39;applicazione venga distribuita.
Questo garantisce tempi di caricamento rapidi per tutte le impostazioni regionali, ma può tradurre solo i contenuti noti in fase di build.

Una volta generate, le traduzioni vengono (1) memorizzate nella CDN oppure (2) memorizzate nell&#39;output di build della tua app, in base alla tua configurazione.
Da lì, il contenuto tradotto viene servito agli utenti.
Se non viene trovata una traduzione, verrà usato come fallback il contenuto originale.

Assicurati di seguire la [guida al deployment qui](/docs/next/tutorials/quickdeploy).

### Sviluppo

Durante lo sviluppo, la funzione `m` tradurrà i contenuti su richiesta.
Questo è utile per farti un&#39;idea di come apparirà la tua app in lingue diverse.
Ricorda di aggiungere una chiave API Dev al tuo ambiente per abilitare questo comportamento.

Noterai un ritardo durante la traduzione su richiesta in fase di sviluppo.
Questo non accadrà nelle build di produzione, a meno che i contenuti non vengano tradotti esplicitamente su richiesta,
ovvero usando [`tx`](/docs/next/api/strings/tx) o [`<Tx>`](/docs/next/api/components/tx).

***

## Esempio

### Utilizzo di base

Puoi usare `getMessages` per tradurre le stringhe codificate da `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>
  );
}
```

Nota: &quot;Alice&quot; sarà tradotto nella lingua preferita dell&#39;utente.


### Utilizzo delle variabili [#variables]

Puoi passare variabili alle stringhe codificate.

```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' })} {/* Questo mostrerà "Hello, Bob!" */}
    </p>
  );
}
```


### Le variabili di `msg` sovrascrivono quelle di `m`

Quando passi variabili sia a `msg` sia a `m`, quelle passate a `msg` sovrascrivono quelle passate a `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>
  );
}
```

Nota: verrà visualizzato &quot;Hello, Alice!&quot; - la variabile non viene sovrascritta in fase di rendering.


### Utilizzare il formato dei messaggi ICU

`gt-next` supporta il formato dei messaggi ICU, che consente anche di formattare le variabili.

```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>
  Il formato dei messaggi ICU è un potente strumento per formattare le variabili.
  Per ulteriori informazioni, consulta la [documentazione sul formato dei messaggi ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Note

* La funzione `getMessages` è una funzione lato server che traduce le stringhe codificate con `msg`.
* La traduzione delle stringhe con `getMessages` avviene prima del runtime, durante il processo di build (tranne che in fase di sviluppo).

## Passaggi successivi

* Vedi [`useMessages`](/docs/next/api/strings/use-messages) per tradurre lato client le stringhe a partire da stringhe codificate in fase di build.
* Vedi [`msg`](/docs/next/api/strings/msg) per codificare le stringhe ai fini della traduzione.
* Per le traduzioni runtime, vedi [`tx`](/docs/next/api/strings/tx) e [`<Tx>`](/docs/next/api/components/tx).