Intl.Collator.supportedLocalesOf()

Baseline 已廣泛支援

此功能已成熟，可跨多種裝置和瀏覽器版本使用。自 2017 年 9 月以來，它已在瀏覽器中提供。

Intl.Collator.supportedLocalesOf() 靜態方法返回一個數組，其中包含在排序時得到支援且無需回退到執行時預設區域設定的給定區域設定中的一部分。

試一試

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

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

語法

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

引數

locales

一個帶有 BCP 47 語言標籤的字串，或者此類字串的陣列。關於 locales 引數的一般形式和解釋，請參閱 Intl 主頁上的引數說明。

options 可選

一個可能具有以下屬性的物件

localeMatcher: 要使用的 locale 匹配演算法。可能的值為 "lookup" 和 "best fit"；預設值為 "best fit"。有關此選項的資訊，請參閱 Intl 頁面。

返回值

一個由字串組成的陣列，代表給定區域設定標籤的一個子集，這些標籤在排序時得到支援，且無需回退到執行時的預設區域設定。

假設一個執行時支援印度尼西亞語和德語，但不支援巴釐語排序，supportedLocalesOf 將原樣返回印度尼西亞語和德語的語言標籤，即使印度尼西亞語未使用 pinyin 排序，並且不太可能支援印尼語的特定德語版本。注意此處指定了 "lookup" 演算法 — "best fit" 匹配器可能會認為印度尼西亞語足夠匹配巴釐語，因為大多數巴釐語使用者也懂印度尼西亞語，因此也會返回巴釐語的語言標籤。

const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.Collator.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]