# General Translation Platform: resolveAliasLocale
URL: https://generaltranslation.com/ru/docs/platform/core/reference/gt-class-methods/locales/resolve-alias-locale.mdx
---

title: resolveAliasLocale
description: Преобразует алиас локали в код локали, используемый в пользовательском сопоставлении. Справочник API для resolveAliasLocale.

---

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

## Обзор [#overview]

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

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"
```

Сигнатура:

```typescript
resolveAliasLocale(
  locale: string,
  customMapping?: CustomMapping
): string
```

*Примечание: `resolveAliasLocale` работает локально и не требует API-ключа. Если `customMapping` не указан, используется `customMapping` экземпляра. Чтобы определить локаль без экземпляра `GT`, см. автономный [`resolveAliasLocale`](/docs/platform/core/reference/utility-functions/locales/resolve-alias-locale).*

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

* **Обратный lookup.** Ищет алиас, настроенный для канонической локали, в [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping).
* **Сквозная передача.** Возвращает входную локаль без изменений, если она уже является алиасом или если сопоставление алиасов отсутствует.
* **Резервное сопоставление.** Если `customMapping` не указан, используется `customMapping` экземпляра.

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

| Параметр                           | Описание                                                                      | Тип                                                                   | Необязательный | По умолчанию         |
| ---------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------- | -------------------- |
| [`locale`](#locale)                | Канонический код локали, для которого нужно определить алиас.                 | `string`                                                              | Нет            | —                    |
| [`customMapping`](#custom-mapping) | Пользовательское сопоставление, используемое вместо сопоставления экземпляра. | [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) | Да             | `this.customMapping` |

### `locale` [#locale]

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

Канонический код локали, для которого нужно получить соответствующий алиас.

### `customMapping` [#custom-mapping]

**Тип** [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) · **Необязательно** · **По умолчанию** `this.customMapping`

Пользовательское сопоставление, используемое вместо сопоставления экземпляра.

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

**Тип** `string`

Настроенный алиас для канонической локали либо исходную локаль без изменений, если она уже является алиасом или если сопоставление алиасов не задано.

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

```typescript
const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    cn: { code: 'zh', name: 'Mandarin' },
  },
});

// Преобразовать каноническую локаль обратно в алиас
const alias = gt.resolveAliasLocale('zh');
console.log(alias); // "cn"

// Локаль без маппинга возвращает исходное значение
const unchanged = gt.resolveAliasLocale('es');
console.log(unchanged); // "es"
```

## Примечания [#notes]

* Возвращает исходный код локали-алиас, если задано пользовательское сопоставление.
* Возвращает переданную локаль без изменений, если сопоставление не найдено.