Übersicht

Die Methode getLocaleEmoji liefert anhand der Region ein Emoji in Form einer Flagge oder eines Symbols für einen locale code. Sie gibt passende Flaggen-Emojis für Länder und Territorien zurück, mit Standardwerten für Sprachen ohne spezifische Region sowie Unterstützung für benutzerdefinierte Emojis über Zuordnungen.

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

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

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

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

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

string – Emoji-Flagge oder Symbol, das die Locale repräsentiert:

• Länder-/Gebietsflaggen-Emoji für Locales mit Regionen (z. B. 🇺🇸, 🇫🇷, 🇯🇵)
• Sprachspezifisches Emoji für einige Sprachen ohne Regionen
• Standard-Flaggen-Emoji (🏳️) für nicht erkannte Locales

Wirft

• Error – Wenn keine locale angegeben ist und die Instanz keine targetLocale konfiguriert hat

Beispiele

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

// Emoji für targetLocale abrufen
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Emojis für verschiedene locales abrufen
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')); // "🇨🇳"

Hinweise

• Gibt Flaggen‑Emojis basierend auf dem Regionscode der locale zurück, wenn verfügbar
• Benutzerdefinierte Emoji‑Zuordnungen haben Vorrang vor der regionsbasierten Auswahl
• Verwendet Unicode‑Regionalindikatorzeichen zur Flaggen­generierung
• Standardmäßig 🏳️ (weiße Flagge) für nicht erkannte oder ungültige locales
• Kompatibel mit allen modernen Browsern und Betriebssystemen, die Unicode‑Emojis unterstützen

Nächste Schritte

• Locale-Eigenschaften mit getLocaleProperties abrufen
• Locale-Namen mit getLocaleName abrufen
• Locales mit isValidLocale validieren
• Mehr über den Typ CustomMapping erfahren](/docs/core/types/custom-mapping)