# gt-node: General Translation Node.js SDK: getLocale
URL: https://generaltranslation.com/ru/docs/node/reference/functions/get-locale.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Чтение активной локали для текущего запроса в General Translation gt-node. Справочник API для getLocale.

Возвращает активную локаль в виде кода BCP 47. Вызывайте её внутри [`withGT`](/docs/node/reference/functions/with-gt), чтобы получить локаль, привязанную к запросу.

## Обзор [#overview]

Вызовите `getLocale` без аргументов, чтобы получить код активной локали BCP 47.

```ts
import { getLocale } from 'gt-node';

const locale = getLocale(); // 'en-US'
```

Сигнатура:

```ts
getLocale(): string
```

*Примечание: `getLocale` необходимо вызывать внутри callback [`withGT`](/docs/node/reference/functions/with-gt), чтобы функция знала, какую локаль использовать.*

## Как это работает [#how-it-works]

* **В области запроса.** Считывает локаль, заданную окружающим вызовом [`withGT`](/docs/node/reference/functions/with-gt).
* **Синхронно.** Возвращает результат сразу и не требует `await`.

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

`getLocale` не принимает параметров.

## Возвращаемое значение [#returns]

**Тип** `string`

Текущий код локали BCP 47 (например, `'en-US'`).

## Примеры [#examples]

```ts title="handler.js"
// Базовое использование
import { withGT, getLocale } from 'gt-node';

app.use((req, res, next) => {
  const locale = req.headers['accept-language']?.split(',')[0] || 'en-US';
  withGT(locale, () => {
    console.log(getLocale()); // 'en-US'
    next();
  });
});
```

## Sitemap

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