# General Translation React SDKs (gt-react, gt-next): registerLocale
URL: https://generaltranslation.com/ru/docs/react/nextjs/reference/functions/register-locale.mdx
---

title: registerLocale
description: Регистрирует локаль для серверного кода Next.js App Router с General Translation. Справочник по API для registerLocale.

---

Функция `registerLocale` устанавливает локаль для текущего контекста запроса App Router. Используйте её в Route Handlers и обработчиках изображений метаданных, где `next/root-params` недоступен. Примеры обработчиков см. в разделе [Регистрация локалей запроса](/docs/react/nextjs/registering-request-locales).

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

## Обзор [#overview]

Вызовите `registerLocale` до вызова любой другой серверной функции `gt-next` в обработчике запроса.

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

registerLocale('fr');
```

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

| Параметр | Описание                                                     | Type     | Необязательный | По умолчанию |
| -------- | ------------------------------------------------------------ | -------- | -------------- | ------------ |
| `locale` | Локаль, которую нужно зарегистрировать для текущего запроса. | `string` | Нет            | —            |

Для неподдерживаемых значений локали используется запасной вариант в соответствии с конфигурацией локалей General Translation.

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

**Тип** `void`

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

```tsx title="app/[locale]/opengraph-image.tsx"
import { ImageResponse } from 'next/og';
import { getGT, registerLocale } from 'gt-next/server';

export default async function Image({ params }) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return new ImageResponse(<div>{gt('Welcome')}</div>);
}
```