Intl.Collator.prototype.resolvedOptions()

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

構文

collator.resolvedOptions()

返値

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

解説

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

locale
実際に使用したロケールの BCP 47 言語タグ。このロケールにつながる入力 BCP 47 言語タグに Unicode 拡張値が要求された場合、要求されたキーと値のペアのうち、このロケールで対応しているものが locale に含まれます。
usage
sensitivity
ignorePunctuation
options 引数の同名のプロパティで提供された値、または既定値が入ります。
collation
locale が対応している場合は、 Unicode 拡張キー "co" を使用して要求された値、そうでなければ "default" です。
numeric
caseFirst
options 引数の同名のプロパティ、または Unicode 拡張キーの "kn" および "kf" で要求された値、または既定値が入ります。実装がこれらのプロパティに対応していない場合は、省略されます。

resolvedOptions メソッドの使用

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

仕様書

仕様書
ECMAScript Internationalization API (ECMA-402)
Intl.Collator.prototype.resolvedOptions の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
resolvedOptionsChrome 完全対応 24Edge 完全対応 12Firefox 完全対応 29IE 完全対応 11Opera 完全対応 15Safari 完全対応 10WebView Android 完全対応 4.4Chrome Android 完全対応 25Firefox Android 完全対応 56Opera Android 完全対応 14Safari iOS 完全対応 10Samsung Internet Android 完全対応 1.5nodejs 完全対応 0.12
補足
完全対応 0.12
補足
補足 Before version 13.0.0, only the locale data for en-US is available by default. See the Collator() constructor for more details.

凡例

完全対応  
完全対応
実装ノートを参照してください。
実装ノートを参照してください。

関連情報