Übersicht

Im Kontext der Alias-Zuordnung von locales (z. B. cn → zh) wandelt die Methode resolveCanonicalLocale Alias-locale-codes in ihre kanonischen BCP‑47‑locale-codes um, wenn eine benutzerdefinierte Zuordnung konfiguriert ist.

Referenzen

Parameter

Parameterbeschreibung

Rückgabewert

string – Der kanonische BCP‑47‑Locale-Code, falls eine Zuordnung existiert, andernfalls der ursprüngliche Locale-Code

Löst aus

• Error – Wenn keine locale übergeben wurde und für die Instanz keine targetLocale konfiguriert ist

Beispiele

const gt = new GT({
  sourceLocale: 'en',
  customMapping: {
    'cn': { code: 'zh', name: 'Mandarin' },
  }
});

// Alias in kanonisches Locale konvertieren
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Reguläre BCP-47-Codes werden unverändert weitergegeben
const unchanged = gt.resolveCanonicalLocale('fr-FR');
console.log(unchanged); // "fr-FR"

Hinweise

• Konvertiert Alias-„locale codes“ in kanonische BCP-47-„locale codes“
• Gibt die ursprüngliche locale zurück, wenn keine benutzerdefinierte Zuordnung existiert
• Funktioniert mit der „customMapping“-Konfiguration des GT-Konstruktors
• Es wird keine Validierung der Eingabe- oder Ausgabe-„locale codes“ vorgenommen

Nächste Schritte

• Aliase mit resolveAliasLocale auflösen
• locales mit isValidLocale validieren
• locale-Format mit standardizeLocale standardisieren