Обзор

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

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

Справочные материалы

Параметры

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

Возвращает

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

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

Исключения

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

Примеры

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

// Получить эмодзи для целевой локали
console.log(gt.getLocaleEmoji()); // "🇪🇸" (использует целевую локаль '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
• Получите названия локалей с помощью getLocaleName
• Проверьте валидность локалей с помощью isValidLocale
• Узнайте о типе CustomMapping