# gt-next: General Translation Next.js SDK: getLocale
URL: https://generaltranslation.com/ru/docs/next/api/helpers/get-locale.mdx
---
title: getLocale
description: Справка по API для серверного метода getLocale
---

## Обзор

Функция `getLocale` возвращает текущую локаль пользователя при серверном рендеринге.
Локаль возвращается в виде BCP 47 [кода локали](/docs/core/locales), например `'en-US'`.

<Callout>
  `getLocale` — это серверный метод, и его можно использовать только в серверных
  компонентах.
</Callout>

Для использования на клиенте см. [`useLocale`](/docs/next/api/helpers/use-locale).

## Справочник

### Возвращает

Промис, который возвращает строку с текущей локалью пользователя, например `'en-US'`.

***

## Поведение при выборе резервной локали

Если запрашивается неподдерживаемая локаль, будет выбрана резервная локаль.

Например, если запрошена неподдерживаемая локаль,
и (1) пользователь указал в настройках браузера несколько предпочтительных локалей,
и (2) одна из этих локалей поддерживается вашим приложением,
тогда в качестве резервной будет выбрана локаль с наиболее подходящим языком.

Кроме того, если подходящих резервных локалей нет,
но две локали используют один и тот же язык (например, `en-US` и `en-GB`),
тогда в качестве резервной будет выбрана поддерживаемая локаль с тем же языком.

Если ни одно из этих условий не выполняется, будет использоваться локаль по умолчанию.

Если локаль, определённая из запроса, недопустима или не поддерживается (например, если статически выглядящий корневой путь разрешается во что-то вроде `llms.txt`), `getLocale` переключается на настроенную локаль по умолчанию и выводит диагностическое сообщение через `console.warn`, а не выбрасывает исключение. Если вы хотите отклонять недопустимые параметры маршрута `[locale]`, а не молча использовать значение по умолчанию, проверьте значение с помощью [`isLocaleSupported`](/docs/next/api/helpers/is-locale-supported) и вызовите `notFound()`.

Сведения о настройке поддерживаемых локалей см. в документации [`gt.config.json`](/docs/next/api/config/gt-config-json).

***

## Примеры

### Базовое использование

Получите локаль пользователя при серверном рендеринге.

```javascript title="GetUserLocale.jsx" copy
import { getLocale } from 'gt-next/server';

export default async function GetUserLocale() {
  const locale = await getLocale(); // [!code highlight]
  return <p>User locale: {locale}</p>;
}
```

***


## Примечания

* Функция `getLocale` асинхронная, поэтому для получения локали нужно использовать `await`.
* Она предназначена именно для использования на сервере. Для клиентских компонентов см. [`useLocale`](/docs/next/api/helpers/use-locale).
* Возвращаемая локаль соответствует формату [кода локали](/docs/core/locales).

## Следующие шаги

* Узнайте, как настроить список поддерживаемых локалей с помощью [withGTConfig()](/docs/next/api/config/with-gt-config).

- Используйте [`isLocaleSupported`](/docs/next/api/helpers/is-locale-supported), чтобы явно отклонять недопустимые параметры маршрута локали.