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

## Обзор

Функция `getRequestLocale` извлекает предпочтительную локаль из заголовка `Accept-Language` запроса и сопоставляет её с локалями, настроенными в проекте.

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

const locale = getRequestLocale(req); // 'fr'
```

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

## Справка

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

<TypeTable
  type={{
  "request": {
    type: 'RequestLike',
    description: 'Объект со свойством headers, содержащим заголовки запроса. Работает с Express, Fastify и любым фреймворком, где заголовки представлены в виде Record<string, string | string[] | undefined>.',
    optional: false,
  },
}}
/>

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

`string` — наиболее подходящий [код локали](/docs/core/locales) BCP 47 из числа настроенных локалей либо `defaultLocale`, если совпадение не найдено.

***

## Примеры

### Middleware для Express

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale = getRequestLocale(req);
  withGT(locale, () => next());
}
```

### Комбинирование с другими подходами

Используйте `getRequestLocale` в качестве резервного варианта, если явные предпочтения не заданы:

```js title="middleware/locale.js"
import { withGT, getRequestLocale } from 'gt-node';

export function localeMiddleware(req, res, next) {
  const locale =
    req.query.lang ||
    req.cookies?.locale ||
    getRequestLocale(req);

  withGT(locale, () => next());
}
```

***

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

* См. [`getLocale`](/docs/node/api/get-locale), чтобы получить локаль в контексте `withGT`.
* См. руководство [Определение локали и middleware](/docs/node/guides/middleware), чтобы ознакомиться со всеми подходами к middleware.