1. 開発者向けのウェブ技術
  2. JavaScript
  3. JavaScript リファレンス
  4. 標準組み込みオブジェクト
  5. Intl
  6. Intl.Segmenter
  7. resolvedOptions()

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Intl.Segmenter.prototype.resolvedOptions()

Baseline 2024
Newly available

Since April 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

resolvedOptions() は Intl.Segmenter インスタンスンのメソッドで、この Segmenter オブジェクトの初期化中に計算されたオプションを反映したプロパティを持つ新しいオブジェクトを返します。

試してみましょう

const segmenter = new Intl.Segmenter("fr-FR");
const options = segmenter.resolvedOptions();

console.log(options.locale);
// 予想される結果: "fr-FR"

console.log(options.granularity);
// 予想される結果: "grapheme"

構文

js
resolvedOptions()

引数

なし。

返値

この Segmenter オブジェクトの初期化時に計算されたオプションを反映したプロパティを持つ新しいオブジェクトです。このオブジェクトには、記載順に次のプロパティがあります。

locale

実際に使用されるロケールの BCP 47 言語タグです。これは、ロケールネゴシエーションの処理によって決定されます。出力には、Unicode 拡張キーは含まれません。

granularity

options 引数でこのプロパティに指定された値です。必要に応じてデフォルト値が設定されます。値は "grapheme"、"word"、"sentence" のいずれかです。デフォルトは "grapheme" です。

例

基本的な使い方

js
const spanishSegmenter = new Intl.Segmenter("es", { granularity: "sentence" });
const options = spanishSegmenter.resolvedOptions();
console.log(options.locale); // "es"
console.log(options.granularity); // "sentence"

デフォルトの粒度

js
const spanishSegmenter = new Intl.Segmenter("es");
const options = spanishSegmenter.resolvedOptions();
console.log(options.locale); // "es"
console.log(options.granularity); // "grapheme"

locale のフォールバック

js
const banSegmenter = new Intl.Segmenter("ban");
const options = banSegmenter.resolvedOptions();
console.log(options.locale);
// Balinese ロケールに対応しておらず、
// デフォルトのロケールが French であるランタイムでは、"fr"
console.log(options.granularity); // "grapheme"

仕様書

Specification
ECMAScript® 2027 Internationalization API Specification
# sec-intl.segmenter.prototype.resolvedoptions

ブラウザーの互換性

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content