# generaltranslation: General Translation Core SDK: resolveAliasLocale
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/resolve-alias-locale.mdx
---
title: resolveAliasLocale
description: Справка по API для метода GT resolveAliasLocale
---

## Обзор

Метод `resolveAliasLocale` возвращает исходный код локали-алиаса по каноническому коду локали, если настроено пользовательское сопоставление.
Это операция, обратная `resolveCanonicalLocale`.

***

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

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

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
    default: 'this.customMapping'
  }
}}
/>

### Описание параметров

| Параметр        | Описание                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------- |
| `locale`        | Код канонической локали, для которой нужно получить соответствующий псевдоним                |
| `customMapping` | Необязательное пользовательское сопоставление, используемое вместо сопоставления экземпляра |

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

`string` — код локали-алиаса, если сопоставление есть; в противном случае — исходный код локали

### Исключения

* `Error` — если локаль не указана и целевая локаль не настроена

***

## Примеры

```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"
```

***


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

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

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

* Определите канонические локали с помощью [`resolveCanonicalLocale`](/docs/core/class/methods/locales/resolve-canonical-locale)
* Проверяйте локали с помощью [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Получите свойства локали с помощью [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)