Intl.getCanonicalLocales()

Baseline 已广泛支持

此功能已非常成熟,可在多种设备和浏览器版本上使用。自 2017 年 10 月以来,它已在各大浏览器中可用。

Intl.getCanonicalLocales() 静态方法返回一个包含规范化区域设置名称的数组。重复项将被省略,并且元素将作为结构有效的语言标签进行验证。

试一试

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"
}

语法

js
Intl.getCanonicalLocales(locales)

参数

locales

要获取规范化区域设置名称的 String 值列表。

返回值

包含规范化区域设置名称的数组。

示例

使用 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"

规范

规范
ECMAScript® 2026 国际化 API 规范
# sec-intl.getcanonicallocales

浏览器兼容性

另见