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

## Обзор

Метод `getLocaleEmoji` возвращает эмодзи-флаг или символ для кода локали в зависимости от региона.
Он возвращает подходящие эмодзи-флаги для стран и территорий, а также предусматривает резервные варианты для языков без конкретного региона и поддержку пользовательских эмодзи через сопоставления.

```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); // "🇺🇸" (флаг США)
```

***


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

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

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

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

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

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

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

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

### Выбрасывает

* `Error` — если локаль не указана и для экземпляра не настроен `targetLocale`

***

## Примеры

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

// Получить эмодзи для целевой локали
console.log(gt.getLocaleEmoji()); // "🇪🇸" (использует 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')); // "🇨🇳"
```

***


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

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

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

* Получите свойства локали с помощью [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Получите названия локалей с помощью [`getLocaleName`](/docs/core/class/methods/locales/get-locale-name)
* Проверьте корректность локалей с помощью [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* [Узнайте больше о типе CustomMapping](/docs/core/types/custom-mapping)