Intl.Collator.prototype.resolvedOptions()

Baseline 已廣泛支援

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

resolvedOptions() 方法是 Intl.Collator 例項的一個方法,它返回一個新物件,該物件包含在初始化此 Collator 物件期間計算出的選項的屬性。

試一試

const numberDe = new Intl.NumberFormat("de-DE");
const numberAr = new Intl.NumberFormat("ar");

console.log(numberDe.resolvedOptions().numberingSystem);
// Expected output: "latn"

console.log(numberAr.resolvedOptions().numberingSystem);
// Expected output: "arab"

語法

js
resolvedOptions()

引數

無。

返回值

一個新物件,包含在初始化此 Collator 物件期間計算出的選項的屬性。該物件按列出順序具有以下屬性:

locale

實際使用的區域設定的 BCP 47 語言標記,由 區域設定協商過程確定。只有在請求並支援的情況下,coknkf Unicode 擴充套件鍵才可能包含在輸出中。

usage

options 引數中為該屬性提供的值,並根據需要填充預設值。它要麼是 "sort",要麼是 "search"。預設值為 "sort"

sensitivity

options 引數中為該屬性提供的值,並根據需要填充預設值。它要麼是 "base""accent""case""variant"。對於 "sort" 用途,預設值為 "variant";對於 "search" 用途,它取決於區域設定。

ignorePunctuation

options 引數中為該屬性提供的值,並根據需要填充預設值。它是一個布林值。對於泰語 (th),預設值為 true;對於所有其他語言,預設值為 false

collation

options 引數中為該屬性提供的值,或使用 Unicode 擴充套件鍵 "co",並根據需要填充預設值。它是此區域設定支援的 排序型別。預設值為 "default"

numeric

options 引數中為該屬性提供的值,或使用 Unicode 擴充套件鍵 "kn",並根據需要填充預設值。它是一個布林值。預設值為 false。如果實現不支援此 Unicode 擴充套件鍵,則此屬性將被省略。

caseFirst

options 引數中為該屬性提供的值,或使用 Unicode 擴充套件鍵 "kf",並根據需要填充預設值。它要麼是 "upper""lower""false"。預設值為 "false"。如果實現不支援此 Unicode 擴充套件鍵,則此屬性將被省略。

示例

使用 resolvedOptions 方法

js
const de = new Intl.Collator("de", { sensitivity: "base" });
const usedOptions = de.resolvedOptions();

usedOptions.locale; // "de"
usedOptions.usage; // "sort"
usedOptions.sensitivity; // "base"
usedOptions.ignorePunctuation; // false
usedOptions.collation; // "default"
usedOptions.numeric; // false

規範

規範
ECMAScript® 2026 國際化 API 規範
# sec-intl.collator.prototype.resolvedoptions

瀏覽器相容性

另見