Intl.getCanonicalLocales()

基线 广泛可用

此功能已得到良好确立，并在许多设备和浏览器版本中均可使用。它已在浏览器中可用，自 2017年9月.

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

试一试

语法

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:'EN_US' is not a structurally valid language tag

规范

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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅