Intl.ListFormat.prototype.resolvedOptions()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
resolvedOptions() は Intl.ListFormat インスタンスのメソッドで、現在の ListFormat オブジェクトの構築時に計算されたロケールとスタイル整形オプションを反映したプロパティを持つ新しいオブジェクトを返します。
試してみましょう
const deListFormatter = new Intl.ListFormat("de-DE", { type: "disjunction" });
const options = deListFormatter.resolvedOptions();
console.log(options.locale);
// 予想される結果: "de-DE"
console.log(options.style);
// 予想される結果: "long"
console.log(options.type);
// 予想される結果: "disjunction"
構文
js
resolvedOptions()
引数
なし。
返値
指定された Intl.ListFormat オブジェクトの構築時に計算されたロケールと整形オプションを反映したプロパティを持つオブジェクトです。
locale-
実際に使用されているロケールの BCP 47 言語タグです。これは、ロケールネゴシエーションのプロセスによって決定されます。出力には、Unicode 拡張キーは記載されません。
type-
options引数でこのプロパティに指定された値です。値は"conjunction"、"disjunction"、"unit"のいずれかです。デフォルト値は"conjunction"です。 style-
options引数でこのプロパティに指定された値です。必要に応じてデフォルト値が設定されます。値は"long"、"short"、"narrow"のいずれかです。デフォルト値は"long"です。
例
resolvedOptions の使用
js
const deListFormatter = new Intl.ListFormat("de-DE", { style: "short" });
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.style); // "short"
console.log(usedOptions.type); // "conjunction" （デフォルト値）
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Internationalization API Specification # sec-Intl.ListFormat.prototype.resolvedoptions |