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

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

---

Проверяет, является ли одна локаль надмножеством другой в иерархии BCP-47 в экземпляре [GT](/docs/platform/core/reference/gt-class/constructor). Локаль-надмножество является более общей и может использоваться как резервная для более конкретных локалей. General Translation использует это для определения цепочек резервных локалей.

## Обзор [#overview]

Вызовите `isSupersetLocale` для экземпляра [`GT`](/docs/platform/core/reference/gt-class/constructor), передав локаль, предположительно являющуюся надмножеством, и локаль, предположительно являющуюся подмножеством. Метод возвращает `true`, если первая является надмножеством второй.

```typescript
const gt = new GT();

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

Сигнатура:

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

*Примечание: `isSupersetLocale` выполняется локально и не требует ключа API. Для сравнений без экземпляра `GT` см. автономную функцию [`isSupersetLocale`](/docs/platform/core/reference/utility-functions/locales/is-superset-locale).*

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

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

## Параметры [#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
const gt = new GT();

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

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

// Одинаковые локали
console.log(gt.isSupersetLocale('en-US', 'en-US')); // true

// Разные языки
console.log(gt.isSupersetLocale('en', 'es-ES')); // false
```

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

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