# node: getLocale
URL: https://generaltranslation.com/ru/docs/node/api/get-locale.mdx
---
title: getLocale
description: Справочник API для функции getLocale
---

## Обзор

Функция `getLocale` возвращает текущую локаль в контексте активного запроса.

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

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

<Callout>
  **Требуется контекст запроса:**
  `getLocale` должен вызываться внутри колбэка [`withGT`](/docs/node/api/with-gt), чтобы понимать, какую локаль использовать.
</Callout>


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

### Параметры

Отсутствуют.

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

`string` — текущий [код локали](/docs/core/locales) в формате BCP 47 (например, `'en-US'`).

***

## Примеры

### Основы использования

```js 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();
  });
});
```

***


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

* См. [`getLocales`](/docs/node/api/get-locales), чтобы получить полный список поддерживаемых локалей.
* См. [`getLocaleProperties`](/docs/node/api/get-locale-properties) для получения метаданных о локали.