Intl.DisplayNames.supportedLocalesOf()

基线广泛可用

此功能已十分成熟，可在许多设备和浏览器版本上正常运行。它自 2021 年 4 月.

报告反馈

语法

Intl.DisplayNames.supportedLocalesOf() 静态方法返回一个数组，其中包含在显示名称中支持的提供的语言环境，而无需回退到运行时的默认语言环境。

Intl.DisplayNames.supportedLocalesOf(locales)
Intl.DisplayNames.supportedLocalesOf(locales, options)

js

参数

locales

一个带有 BCP 47 语言标签的字符串，或此类字符串的数组。有关 locales 参数的通用形式和解释，请参阅 Intl 主页上的参数说明。

options 可选

一个可能具有以下属性的对象: localeMatcher

要使用的语言环境匹配算法。可能的值为 `"lookup"` 和 `"best fit"`；默认值为 `"best fit"`。有关此选项的信息，请参阅 Intl 页面。

返回值

示例

一个字符串数组，表示给定语言环境标签的子集，这些语言环境标签在显示名称中受支持，而无需回退到运行时的默认语言环境。

使用 supportedLocalesOf()

Intl.DisplayNames.supportedLocalesOf() 静态方法返回一个数组，其中包含在显示名称中支持的提供的语言环境，而无需回退到运行时的默认语言环境。

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

假设一个运行时支持印尼语和德语，但不支持巴厘语在显示名称中，`supportedLocalesOf` 返回印尼语和德语语言标签，保持不变，即使 `pinyin` 排序规则与显示名称无关，也不适用于印尼语，并且专门用于印尼的德语不太可能得到支持。请注意此处 `"lookup"` 算法的规范——`"best fit"` 匹配器可能会决定印尼语是巴厘语的适当匹配，因为大多数巴厘语使用者也理解印尼语，因此也返回巴厘语语言标签。
规范 # ECMAScript 国际化 API 规范

假设一个运行时支持印尼语和德语，但不支持巴厘语在显示名称中，supportedLocalesOf 返回印尼语和德语语言标签，保持不变，即使 pinyin 排序规则与显示名称无关，也不适用于印尼语，并且专门用于印尼的德语不太可能得到支持。请注意此处 "lookup" 算法的规范——"best fit" 匹配器可能会决定印尼语是巴厘语的适当匹配，因为大多数巴厘语使用者也理解印尼语，因此也返回巴厘语语言标签。

规范
# ECMAScript 国际化 API 规范