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

## Обзор

Функция `getLocaleProperties` возвращает метаданные об указанной локали, включая её название, самоназвание, язык, регион и сведения о письменности.

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

const props = getLocaleProperties('en-US');
console.log(props.name); // 'Американский английский'
```


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

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

| Параметр | Тип      | Описание                                                                                                |
| -------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `locale` | `string` | Код локали в формате BCP 47 (например, `'en-US'`, `'ja'`). Если не указан, используется текущая локаль. |

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

Объект `LocaleProperties` со следующими полями:

| Поле                       | Тип      | Описание                                                                  |
| -------------------------- | -------- | ------------------------------------------------------------------------- |
| `code`                     | `string` | Код локали (например, `'en-US'`).                                         |
| `name`                     | `string` | Английское название локали (например, `'American English'`).              |
| `nativeName`               | `string` | Название локали на её собственном языке (например, `'American English'`). |
| `languageCode`             | `string` | Подтег языка (например, `'en'`).                                          |
| `languageName`             | `string` | Английское название языка (например, `'English'`).                        |
| `nativeLanguageName`       | `string` | Название языка на его собственном языке (например, `'English'`).          |
| `nameWithRegionCode`       | `string` | Название локали с указанием региона (например, `'English (US)'`).         |
| `nativeNameWithRegionCode` | `string` | Название локали на её собственном языке с указанием региона.              |
| `regionCode`               | `string` | Подтег региона (например, `'US'`).                                        |
| `regionName`               | `string` | Английское название региона (например, `'United States'`).                |
| `nativeRegionName`         | `string` | Название региона на языке локали.                                         |
| `scriptCode`               | `string` | Подтег письменности (например, `'Latn'`).                                 |
| `scriptName`               | `string` | Английское название письменности (например, `'Latin'`).                   |
| `nativeScriptName`         | `string` | Название письменности на её собственном языке.                            |
| `maximizedCode`            | `string` | Полностью развернутый код локали (например, `'en-Latn-US'`).              |

***

## Примеры

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

```js title="handler.js"
import { getLocaleProperties } from 'gt-node';

app.get('/api/locale-info', (req, res) => {
  const props = getLocaleProperties('ja');
  res.json({
    name: props.name,           // 'Japanese'
    nativeName: props.nativeName, // '日本語'
    script: props.scriptName,   // 'Japanese'
  });
});
```

***


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

* Эта функция синхронная — её не нужно ожидать через `await`.
* Полезно для создания селекторов локали или отображения пользователям метаданных локали.

## Что дальше

* См. [`getLocale`](/docs/node/api/get-locale), чтобы получить текущую локаль запроса.
* Подробнее о [кодах локалей](/docs/core/locales).