Intl.Collator.prototype.resolvedOptions()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年9月.
resolvedOptions() は Intl.Collator インスタンスのメソッドで、この Collator オブジェクトの初期化時に計算されたオプションを反映したプロパティを持つ、新しいオブジェクトを返します。
試してみましょう
const numberDe = new Intl.NumberFormat("de-DE");
const numberAr = new Intl.NumberFormat("ar");
console.log(numberDe.resolvedOptions().numberingSystem);
// 予想される結果: "latn"
console.log(numberAr.resolvedOptions().numberingSystem);
// 予想される結果: "arab"
構文
resolvedOptions()
引数
なし。
返値
この Collator オブジェクトの初期化時に計算されたオプションを反映したプロパティを持つ、新しいオブジェクトです。このオブジェクトは以下のプロパティを、掲載順に保持します。
locale-
実際に使用されているロケールの BCP 47 言語タグで、ロケールネゴシエーションプロセスで定められます。Unicode の
co、kn、kf拡張キーのみが、リクエストされ、かつ対応している場合に限り、出力に含まれる可能性があります。 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 拡張キーに対応していない場合、このプロパティは省略されます。s
例
resolvedOptions メソッドの使用
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
仕様書
| Specification |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-intl.collator.prototype.resolvedoptions |