Overview

The getLocaleEmoji method returns an emoji flag or symbol for a locale code based on its region. It provides appropriate flag emojis for countries and territories, with fallbacks for languages without specific regions, and supports custom emojis via mappings.

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

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (Canadian flag)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (US flag)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (US flag)

Reference

Parameters

Parameters Description

Returns

string – Emoji flag or symbol representing the locale:

• Country/territory flag emoji for locales with regions (e.g. 🇺🇸, 🇫🇷, 🇯🇵)
• Language-specific emoji for some languages without regions
• Default flag emoji (🏳️) for unrecognised locales

Throws

• Error – if no locale is provided and the instance has no targetLocale configured

Examples

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

// Get emoji for target locale
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Get emojis for different locales
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

• Returns flag emojis based on the locale’s region code when available
• Custom mapping emojis take priority over region-based selection
• Uses Unicode regional indicator symbols to generate flags
• Defaults to 🏳️ (white flag) for unrecognised or invalid locales
• Compatible with all modern browsers and operating systems that support Unicode emojis

Next steps

• Get locale properties with getLocaleProperties
• Get locale names with getLocaleName
• Validate locales with isValidLocale
• Learn about the CustomMapping type](/docs/core/types/custom-mapping)