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

title: getMessages
description: 使用 General Translation 在异步 Next.js App Router 组件中解析编码后的消息。getMessages 的 API 参考。

---

`getMessages` 函数会返回一个异步解析器，用于处理通过 [`msg`](/docs/react/reference/functions/msg) 注册的 messages。当异步组件无法使用 [`useMessages`](/docs/react/reference/hooks/use-messages) 时，请从 `gt-next/server` 导入它。

`getMessages` 仅限服务器端使用，不支持 Pages Router。

## 概览 [#overview]

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

const greeting = msg('Hello, world!');
const m = await getMessages();
const translated = m(greeting);
```

## 返回值 [#returns]

**类型** `Promise<(encodedContent: string, options?: object) => string>`

解析后返回的函数会根据当前请求的区域设置翻译编码后的内容。调用 `msg` 时传入的变量优先于传递给解析器的变量。

## 示例 [#example]

```tsx title="app/status/page.tsx"
import { msg } from 'gt-next';
import { getMessages } from 'gt-next/server';

const STATUS = {
  active: msg('Active'),
  paused: msg('Paused'),
};

export default async function StatusPage() {
  const m = await getMessages();
  return <p>{m(STATUS.active)}</p>;
}
```