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

浏览器兼容性

另见