Intl.Segmenter.supportedLocalesOf()

Baseline 2024
新推出

自 ⁨2024 年 4 月⁩ 起,此功能可在最新的设备和浏览器版本中运行。此功能可能不适用于较旧的设备或浏览器。

Intl.Segmenter.supportedLocalesOf() 静态方法返回一个数组,其中包含所提供区域设置中支持分段(无需回退到运行时的默认区域设置)的区域设置。

试一试

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup", granularity: "string" };

console.log(Intl.Segmenter.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)

语法

js
Intl.Segmenter.supportedLocalesOf(locales)
Intl.Segmenter.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.Segmenter.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]

规范

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

浏览器兼容性

另见