# gt-next: General Translation Next.js SDK: getMessages
URL: https://generaltranslation.com/es/docs/next/api/strings/get-messages.mdx
---
title: getMessages
description: Referencia de la API de la función getMessages() para traducir cadenas
---

## Descripción general

La función `getMessages` es asíncrona y sirve para traducir cadenas codificadas con `msg` durante la compilación.

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

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

<Callout>
  **Traducción en tiempo de compilación:**
  Las traducciones de `getMessages` se realizan en tiempo de compilación, antes de que se despliegue tu aplicación.
  Puedes pasar cadenas codificadas desde `msg` y se traducirán al idioma preferido del usuario.
</Callout>


## Referencia

### Parámetros

Ninguno

### Devuelve

Una promesa de una función de devolución de llamada, `m`, que traduce el contenido codificado proporcionado por `msg`.

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

| Nombre           | Tipo                  | Descripción                                                     |
| ---------------- | --------------------- | --------------------------------------------------------------- |
| `encodedContent` | `string`              | El contenido de texto codificado de `msg` que se va a traducir. |
| `options?`       | `Record<string, any>` | Parámetros opcionales para pasar variables al texto codificado. |

***


## Funcionamiento

### Producción

Durante el proceso de CD, cualquier contenido dentro de una función `msg` se traducirá antes de que tu aplicación se despliegue.
Esto garantiza tiempos de carga rápidos para todas las configuraciones regionales, pero solo puede traducir contenido conocido en tiempo de compilación.

Una vez generadas, las traducciones se almacenan (1) en la CDN o (2) en la salida de compilación de tu aplicación, según tu configuración.
A partir de ahí, el contenido traducido se sirve a tus usuarios.
Si no se encuentra una traducción, se usará el contenido original.

Asegúrate de seguir la [guía de despliegue aquí](/docs/next/tutorials/quickdeploy).

### Desarrollo

Durante el desarrollo, la función `m` traducirá el contenido bajo demanda.
Esto es útil para prototipar cómo se verá tu aplicación en distintos idiomas.
Recuerda añadir una clave de API de desarrollo a tu entorno para habilitar este comportamiento.

Verás un retraso durante la traducción bajo demanda en desarrollo.
Esto no ocurrirá en las compilaciones de producción, a menos que el contenido se traduzca explícitamente bajo demanda,
es decir, usando [`tx`](/docs/next/api/strings/tx) o [`<Tx>`](/docs/next/api/components/tx).

***

## Ejemplo

### Uso básico

Puedes usar `getMessages` para traducir cadenas codificadas con `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; se traducirá al idioma que prefiera el usuario.


### Uso de variables [#variables]

Puedes pasar variables a las cadenas codificadas.

```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' })} {/* Esto mostrará "Hello, Bob!" */}
    </p>
  );
}
```


### Las variables de `msg` sobrescriben las de `m`

Cuando pasas variables tanto a `msg` como a `m`, las que pasas a `msg` sobrescriben las que pasas 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: Esto mostrará &quot;¡Hola, Alice!&quot;: la variable no se sobrescribe al renderizar.


### Uso del formato de mensajes ICU

`gt-next` admite el formato de mensajes ICU, que también te permite formatear las 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>
  El formato de mensajes ICU es una forma eficaz de dar formato a las variables.
  Para obtener más información, consulta la [documentación sobre el formato de mensajes ICU](https://unicode-org.github.io/icu/userguide/format_parse/messages/).
</Callout>

***


## Notas

* La función `getMessages` es una función del servidor que traduce cadenas codificadas de `msg`.
* La traducción de cadenas con `getMessages` ocurre antes del runtime, durante el proceso de compilación (salvo en desarrollo).

## Siguientes pasos

* Consulta [`useMessages`](/docs/next/api/strings/use-messages) para traducir cadenas en el cliente a partir de cadenas codificadas en tiempo de compilación.
* Consulta [`msg`](/docs/next/api/strings/msg) para codificar cadenas para su traducción.
* Para las traducciones en runtime, consulta [`tx`](/docs/next/api/strings/tx) y [`<Tx>`](/docs/next/api/components/tx).