Überblick

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

Gibt zurück

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

Löst aus

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

Beispiele

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

// Alias zu kanonischem Locale auflösen
const canonical = gt.resolveCanonicalLocale('cn');
console.log(canonical); // "zh"

// Reguläre BCP-47-Codes werden unverändert durchgereicht
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 vorhanden ist
• Funktioniert mit der customMapping-Konfiguration des GT-Konstruktors
• Es erfolgt keine Validierung der Eingabe- oder Ausgabe-locale-Codes

Nächste Schritte

• Zu Aliasen auflösen mit resolveAliasLocale
• locales mit isValidLocale validieren
• Das locale-Format mit standardizeLocale standardisieren