# General Translation React SDKs (gt-react, gt-next, gt-react-native): tx
URL: https://generaltranslation.com/ru/docs/react/nextjs/reference/functions/tx.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Перевод строк во время обработки запроса в серверном коде Next.js App Router с помощью General Translation. Справочник API для tx.

Функция `tx` переводит строку во время обработки запроса через API перевода General Translation. Используйте её для динамического контента, который неизвестен на этапе сборки; для статических исходных строк используйте [`getGT`](/docs/react/nextjs/reference/functions/get-gt).

`tx` работает только на сервере и не поддерживается в Pages Router.

## Обзор [#overview]

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

const translated = await tx('A message loaded at request time');
```

## Параметры [#parameters]

| Параметр  | Описание                                                                          | Тип      | Необязательный | По умолчанию |
| --------- | --------------------------------------------------------------------------------- | -------- | -------------- | ------------ |
| `message` | Строка для перевода.                                                              | `string` | Нет            | —            |
| `options` | Целевая локаль, контекст, формат, ограничение по длине и переменные интерполяции. | `object` | Да             | `{}`         |

`options` принимает `$locale`, `$context`, `$maxChars` и `$format`. Передавайте переменные интерполяции как ключи верхнего уровня. `$maxChars` запрашивает у службы перевода максимальную длину в виде положительного целого числа и при необходимости обрезает возвращаемую строку до этой длины.

## Возвращает [#returns]

**Тип** `Promise<string>`

Промис, который возвращает переведённую строку, либо исходную строку, если перевод отключён или не нужен.

## Пример [#example]

```tsx title="app/notes/[id]/page.tsx"
import { tx } from 'gt-next/server';

export default async function NotePage({ params }) {
  const note = await loadNote((await params).id);
  const translated = await tx(note, {
    $context: 'A user-created note',
  });
  return <p>{translated}</p>;
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.