# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/ru/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji.mdx
---

title: getLocaleEmoji
description: Возвращает эмодзи-маркер для локали или региона. Справка по API для getLocaleEmoji.

---

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

## Обзор [#overview]

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

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'fr-CA' });

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (флаг Канады)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (флаг США)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (флаг США)
```

Сигнатура:

```typescript
getLocaleEmoji(locale?: string): string
```

*Примечание: `getLocaleEmoji` выполняется локально и не требует ключа API. Функция использует `targetLocale` экземпляра, если `locale` не указан. Если нужно выполнить поиск без экземпляра `GT`, см. отдельную функцию [`getLocaleEmoji`](/docs/platform/core/reference/utility-functions/locales/get-locale-emoji).*

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

* **Выбор по региону.** Использует код региона локали (если он доступен) для выбора эмодзи флага, составленного из региональных индикаторных символов Unicode.
* **Приоритет пользовательского сопоставления.** Эмодзи, заданные в [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping), имеют приоритет над выбором по региону.
* **Резервные варианты.** Возвращает языковой эмодзи для некоторых языков без региона, а для нераспознанных или недопустимых локалей — эмодзи глобуса по умолчанию `🌍`.
* **Отсутствующая локаль.** Вызывает `Error`, если локаль не указана и для экземпляра не настроен `targetLocale`.

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

| Параметр            | Описание                                                  | Тип      | Необязательный | По умолчанию        |
| ------------------- | --------------------------------------------------------- | -------- | -------------- | ------------------- |
| [`locale`](#locale) | Код локали BCP-47, для которой требуется получить эмодзи. | `string` | Да             | `this.targetLocale` |

### `locale` [#locale]

**Тип** `string` · **Необязательный** · **По умолчанию** `this.targetLocale`

Код локали BCP-47, для которой нужно получить эмодзи. Если не указан, используется `targetLocale` этого экземпляра.

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

**Тип** `string`

Эмодзи флага или символ, обозначающий локаль:

* Эмодзи флага страны/территории для локалей с регионами (например, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Языковой эмодзи для некоторых языков без регионов.
* Эмодзи глобуса по умолчанию (`🌍`) для нераспознанных локалей.

Вызывает `Error`, если локаль не указана и у экземпляра не настроен `targetLocale`.

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

```typescript
const gt = new GT({ sourceLocale: 'en', targetLocale: 'es' });

// Получить эмодзи для целевой локали
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Получить эмодзи для разных локалей
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"
```

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

* Возвращает эмодзи флагов на основе кода региона локали, если он доступен.
* Эмодзи из пользовательского сопоставления имеют приоритет над выбором по региону.
* Использует региональные индикаторные символы Unicode для генерации флагов.
* По умолчанию использует `🌍` (глобус) для нераспознанных или некорректных локалей.
* Совместимо со всеми современными браузерами и операционными системами, поддерживающими эмодзи Unicode.