Overview

The standalone getLocaleEmoji function retrieves an emoji flag or symbol for a locale code without requiring a GT class instance. It returns the appropriate flag emojis for countries and territories based on the locale’s region, with support for custom emoji mappings.

import { getLocaleEmoji } from 'generaltranslation';

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

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

Reference

Parameters

Parameter descriptions

Returns

string - Emoji flag or symbol representing the locale:

• Country/territory flag emoji for locales with regions (e.g., 🇺🇸, 🇫🇷, 🇯🇵)
• Custom emoji if defined in mapping
• Default flag emoji (🏳️) for unrecognised locales

Examples

Basic emoji retrieval

import { getLocaleEmoji } from 'generaltranslation';

// Common country flags
console.log(getLocaleEmoji('en-US')); // "🇺🇸"
console.log(getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(getLocaleEmoji('zh-CN')); // "🇨🇳"

// Regions with multiple languages
console.log(getLocaleEmoji('en-CA')); // "🇨🇦"
console.log(getLocaleEmoji('fr-CA')); // "🇨🇦"
console.log(getLocaleEmoji('de-CH')); // "🇨🇭"
console.log(getLocaleEmoji('fr-CH')); // "🇨🇭"

Notes

• Returns flag emojis using Unicode Regional Indicator Symbols
• Custom-mapped emojis take precedence over region-based selection
• Supports all ISO 3166-1 alpha-2 region codes for comprehensive coverage

Next steps

• Use the GT class method getLocaleEmoji
• Retrieve locale properties with getLocaleProperties
• Retrieve locale names with getLocaleName
• Validate locales with isValidLocale