# General Translation React SDKs (gt-react, gt-next): useMessages
URL: https://generaltranslation.com/es/docs/react/reference/hooks/use-messages.mdx
---

title: useMessages
description: Resuelve las cadenas registradas con msg en la configuración regional activa con gt-react de General Translation. Referencia de la API para useMessages.

---

El `hook` `useMessages` devuelve una función que resuelve cadenas codificadas creadas con [`msg`](/docs/react/reference/functions/msg) a la configuración regional activa. Úsalo para traducir cadenas registradas en el ámbito del módulo, fuera de un componente.

*Disponible en `gt-react`, `gt-next`, `gt-tanstack-start` y `gt-react-native`. Los ejemplos importan desde `gt-react`; en su lugar, importa desde el paquete de tu framework.*

## Resumen [#overview]

Registra una cadena con `msg` y luego resuélvela con el valor que devuelve la función `useMessages`.

```tsx
const m = useMessages();

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

*Nota: En `gt-react`, llama a `useMessages` dentro de un [`<GTProvider>`](/docs/react/reference/components/gt-provider). En `gt-next`, también funciona en componentes de servidor sincrónicos.*

## Cómo funciona [#how-it-works]

* **Resuelve las cadenas registradas.** Busca la traducción de una cadena codificada previamente con [`msg`](/docs/react/reference/functions/msg) y la devuelve en la configuración regional activa.
* **Paso directo.** `null` y `undefined` se devuelven sin cambios.
* **Precedencia de variables.** Cuando se pasan variables tanto a `msg` como al resolver, los valores pasados a `msg` tienen prioridad.
* **Traducción en tiempo de compilación.** Al igual que [`useGT`](/docs/react/reference/hooks/use-gt), la traducción se realiza en tiempo de compilación (o bajo demanda durante el desarrollo), y las variables nunca se traducen.

## Parámetros [#parameters]

`useMessages` no acepta parámetros.

## Devuelve [#returns]

**Tipo** `(encodedContent: string, options?: object) => string`

Una función que resuelve el contenido codificado de `msg` según la configuración regional activa.

| Nombre           | Descripción                                                       | Tipo     | Opcional |
| ---------------- | ----------------------------------------------------------------- | -------- | -------- |
| `encodedContent` | La cadena codificada de `msg` que debe resolverse.             | `string` | No       |
| `options`        | Variables de interpolación que se pasarán a la cadena codificada. | `object` | Sí       |

## Ejemplos [#examples]

```tsx
import { msg, useMessages } from 'gt-react';

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

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting)}</p>;
}
```

```tsx
import { msg, useMessages } from 'gt-react';

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

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting, { name: 'Bob' })}</p>; // "¡Hola, Bob!"
}
```

```tsx
import { msg, useMessages } from 'gt-react';

// Las variables pasadas a msg() tienen prioridad sobre las pasadas a m()
const encodedGreeting = msg('Hello, {name}!', { name: 'Alice' });

export default function TranslateGreeting() {
  const m = useMessages();
  return <p>{m(encodedGreeting, { name: 'Bob' })}</p>; // "Hello, Alice!"
}
```

## Notas [#notes]

* `useMessages` resuelve cadenas codificadas de [`msg`](/docs/react/reference/functions/msg).
* En un componente async de App Router, usa [`getMessages`](/docs/react/nextjs/reference/functions/get-messages) en su lugar.
* Las traducciones se realizan en tiempo de compilación (o bajo demanda durante el desarrollo).