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 September 2017.

Intl.Collator.prototype.resolvedOptions() メソッドは、この Intl.Collator オブジェクトの初期化時に計算されたロケールと照合オプションを反映したプロパティを持つ新しいオブジェクトを返します。

試してみましょう

構文

js
resolvedOptions();

返値

この Intl.Collator オブジェクトの初期化時に計算されたロケールと照合オプションを反映したプロパティを持つ新しいオブジェクトです。

解説

返されるオブジェクトには、以下のプロパティがあります。

locale

実際に使用したロケールの BCP 47 言語タグ。このロケールにつながる入力 BCP 47 言語タグに Unicode 拡張値が要求された場合、要求されたキーと値のペアのうち、このロケールで対応しているものが locale に含まれます。

usage, sensitivity, ignorePunctuation

options 引数の同名のプロパティで提供された値、または既定値が入ります。

collation

locale が対応している場合は、 Unicode 拡張キー "co" を使用して要求された値、そうでなければ "default" です。

numeric, caseFirst

options 引数の同名のプロパティ、または Unicode 拡張キーの "kn" および "kf" で要求された値、または既定値が入ります。実装がこれらのプロパティに対応していない場合は、省略されます。

resolvedOptions メソッドの使用

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

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

仕様書

Specification
ECMAScript Internationalization API Specification
# sec-intl.collator.prototype.resolvedoptions

ブラウザーの互換性

BCD tables only load in the browser

関連情報