Intl.ListFormat.supportedLocalesOf()
该 Intl.ListFormat.supportedLocalesOf()
静态方法返回一个数组,其中包含提供的区域设置中那些在列表格式化中受支持的区域设置,而无需回退到运行时的默认区域设置。
语法
js
Intl.ListFormat.supportedLocalesOf(locales)
Intl.ListFormat.supportedLocalesOf(locales, options)
参数
locales
-
具有 BCP 47 语言标记的字符串,或此类字符串的数组。有关
locales
参数的一般形式和解释,请参阅Intl
主页上的参数描述。 options
可选-
一个可能具有以下属性的对象
localeMatcher
-
要使用的区域设置匹配算法。可能的值为
"lookup"
和"best fit"
;默认值为"best fit"
。有关此选项的信息,请参阅Intl 页面。
返回值
一个字符串数组,表示给定区域设置标签的子集,这些标签在列表格式化中受支持,而无需回退到运行时的默认区域设置。
示例
使用 supportedLocalesOf()
假设一个运行时在列表格式化中支持印度尼西亚语和德语,但不支持巴厘语,则 supportedLocalesOf
会返回印度尼西亚语和德语语言标签不变,即使 pinyin
排序与列表格式化无关也未与印度尼西亚语一起使用,并且不太可能支持印度尼西亚语的专业德语。请注意此处 "lookup"
算法的规范——"best fit"
匹配器可能会认为印度尼西亚语是巴厘语的足够匹配,因为大多数巴厘语使用者也理解印度尼西亚语,因此也会返回巴厘语语言标签。
js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.ListFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
规范
规范 |
---|
ECMAScript 国际化 API 规范 # sec-Intl.ListFormat.supportedLocalesOf |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。