# General Translation Platform: isSupersetLocale
URL: https://generaltranslation.com/ru/docs/platform/core/reference/utility-functions/locales/is-superset-locale.mdx
---

title: isSupersetLocale
description: Проверяет, может ли одна локаль представлять другую, более специфичную локаль, без экземпляра GT. Справочник по API для isSupersetLocale.

---

[`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) — это отдельная вспомогательная функция из основной библиотеки General Translation, которая проверяет, является ли одна локаль надмножеством другой в иерархии BCP-47 — то есть может ли она представлять более специфичную локаль.

## Обзор [#overview]

Импортируйте `isSupersetLocale` напрямую из `generaltranslation` и вызовите эту функцию, передав локаль-надмножество и локаль-подмножество. Для этого не требуется API-ключ или экземпляр [GT](/docs/platform/core/reference/gt-class/constructor). Эквивалентный вариант на основе экземпляра: используйте метод [`isSupersetLocale`](/docs/platform/core/reference/gt-class-methods/locales/is-superset-locale) у экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { isSupersetLocale } from 'generaltranslation';

console.log(isSupersetLocale('en', 'en-US')); // true
console.log(isSupersetLocale('en-US', 'en')); // false
```

Сигнатура:

```typescript
isSupersetLocale(superLocale: string, subLocale: string): boolean
```

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

* **Проверка по иерархии.** Используется иерархия локалей BCP-47. `subLocale` является подмножеством `superLocale`, если это расширение `superLocale` или если они совпадают.
* **Базовые языки.** Базовый язык является надмножеством своих региональных вариантов, но региональный вариант не является надмножеством базового языка.
* **Рефлексивность.** Локаль всегда является надмножеством самой себя.

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

| Параметр                       | Описание                                        | Тип      | Необязательный | По умолчанию |
| ------------------------------ | ----------------------------------------------- | -------- | -------------- | ------------ |
| [`superLocale`](#super-locale) | Локаль, проверяемая как возможное надмножество. | `string` | Нет            | —            |
| [`subLocale`](#sub-locale)     | Локаль, проверяемая как возможное подмножество. | `string` | Нет            | —            |

### `superLocale` [#super-locale]

**Тип** `string` · **Обязательно**

Локаль, которую нужно проверить на предмет того, является ли она потенциальным надмножеством.

### `subLocale` [#sub-locale]

**Тип** `string` · **Обязательно**

Локаль, которую нужно проверить на принадлежность к потенциальному подмножеству.

## Возвращает [#returns]

**Тип** `boolean`

`true`, если `superLocale` является надмножеством `subLocale`, иначе — `false`.

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

```typescript
import { isSupersetLocale } from 'generaltranslation';

// Базовый язык является надмножеством регионального варианта
console.log(isSupersetLocale('en', 'en-US')); // true
console.log(isSupersetLocale('es', 'es-ES')); // true

// Региональный вариант НЕ является надмножеством базового языка
console.log(isSupersetLocale('en-US', 'en')); // false

// Локаль всегда является надмножеством самой себя
console.log(isSupersetLocale('en-US', 'en-US')); // true
```

## Заметки [#notes]

* Использует иерархию локалей BCP-47.
* Базовые языки — надмножества региональных вариантов.
* Любая локаль является надмножеством самой себя.
* Это необходимо для построения резервных механизмов.