Intl.PluralRules.supportedLocalesOf()

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上使用。自 2019 年 9 月以來,它已在各種瀏覽器中可用。

Intl.PluralRules.supportedLocalesOf() 靜態方法返回一個數組,其中包含提供的區域設定中支援複數規則且無需回退到執行時預設區域設定的部分。

試一試

const locales = ["en-US", "ban", "ar-OM", "de-DE"];
const options = { localeMatcher: "lookup" };

console.log(Intl.PluralRules.supportedLocalesOf(locales, options));
// Expected output: Array ["en-US", "ar-OM", "de-DE"]

語法

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

規範

規範
ECMAScript® 2026 國際化 API 規範
# sec-intl.pluralrules.supportedlocalesof

瀏覽器相容性

另見