Überblick

Die Methode isValidLocale prüft, ob ein Locale-Code korrekt formatiert ist und als gültige BCP‑47‑Locale erkannt wird. Sie überprüft die Locale‑Struktur, die Sprachzuordnung sowie die Gültigkeit von Region/Schrift mithilfe der Intl‑APIs und unterstützt benutzerdefinierte Locale‑Abbildungen.

Referenz

Parameter

Parameterbeschreibung

Rückgabewert

boolean – true, wenn die locale gültig ist, sonst false

Löst aus

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

Beispiele

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

const isValid = gt.isValidLocale('en-US');
console.log(isValid); // true

const isInvalid = gt.isValidLocale('invalid-locale');
console.log(isInvalid); // false

Hinweise

• Führt eine umfassende BCP-47-Validierung von locales mithilfe der browserseitigen Intl APIs durch
• Benutzerdefinierte Mapping-locales werden immer als true validiert (umgeht die Standardvalidierung)
• Unterstützt Sprachcodes für den privaten Gebrauch (qaa–qtz)
• Gibt false für fehlerhafte oder nicht erkannte locale codes zurück

Nächste Schritte

• Locale-Eigenschaften mit getLocaleProperties abrufen
• Beste Locale mit determineLocale ermitteln
• Locale-Namen mit getLocaleName abrufen
• Mehr über den Typ CustomMapping erfahren