Intl.DisplayNames.supportedLocalesOf()
Intl.DisplayNames.supportedLocalesOf() 静态方法返回一个数组,其中包含提供的地区设置中在显示名称方面受支持的地区设置,而无需回退到运行时默认地区设置。
语法
js
Intl.DisplayNames.supportedLocalesOf(locales)
Intl.DisplayNames.supportedLocalesOf(locales, options)
参数
locales-
一个带有 BCP 47 语言标签的字符串,或者此类字符串的数组。关于
locales参数的一般形式和解释,请参阅Intl主页上的参数说明。 options可选-
一个可能具有以下属性的对象
localeMatcher-
要使用的 locale 匹配算法。可能的值为
"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.DisplayNames.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
规范
| 规范 |
|---|
| ECMAScript® 2026 国际化 API 规范 # sec-Intl.DisplayNames.supportedLocalesOf |
浏览器兼容性
加载中…