Intl.Collator.prototype.resolvedOptions()

試してみましょう

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

仕様書

ブラウザーの互換性

関連情報

• Intl.Collator