Intl.DisplayNames.supportedLocalesOf()

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

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

瀏覽器相容性

另見