Intl.getCanonicalLocales()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2017 browserübergreifend verfügbar.
Die Intl.getCanonicalLocales() statische Methode gibt ein Array zurück,
das die kanonischen Locale-Namen enthält. Duplikate werden ausgelassen und Elemente werden
als strukturell gültige Sprach-Tags validiert.
Probieren Sie es aus
console.log(Intl.getCanonicalLocales("EN-US"));
// Expected output: Array ["en-US"]
console.log(Intl.getCanonicalLocales(["EN-US", "Fr"]));
// Expected output: Array ["en-US", "fr"]
try {
Intl.getCanonicalLocales("EN_US");
} catch (err) {
console.log(err.toString());
// Expected output: RangeError: invalid language tag: "EN_US"
}
Syntax
js
Intl.getCanonicalLocales(locales)
Parameter
Rückgabewert
Ein Array, das die kanonischen Locale-Namen enthält.
Beispiele
Verwendung von getCanonicalLocales
js
Intl.getCanonicalLocales("EN-US"); // ["en-US"]
Intl.getCanonicalLocales(["EN-US", "Fr"]); // ["en-US", "fr"]
Intl.getCanonicalLocales("EN_US");
// RangeError: invalid language tag: "EN_US"
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl.getcanonicallocales |