Intl.getCanonicalLocales()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Oktober 2017.
Die Intl.getCanonicalLocales() statische Methode gibt ein Array zurück, das die kanonischen Sprachgebietsschemata enthält. Duplikate werden weggelassen 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 Sprachgebietsschemata 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:'EN_US' is not a structurally valid language tag
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification # sec-intl.getcanonicallocales |
Browser-Kompatibilität
Loading…