Intl.Segmenter.supportedLocalesOf()

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.

Intl.Segmenter.supportedLocalesOf() メソッドは、指定したロケールのうち、ランタイムのデフォルトロケールにフォールバックすることなくサポートされているものを含む配列を返します。

試してみましょう

構文

js
supportedLocalesOf(locales);
supportedLocalesOf(locales, options);

引数

locales

BCP 47 の言語タグを持つ文字列、またはそのような文字列の配列。引数 locales の一般的な形式と解釈については、Intl のページを参照してください。

options 省略可

以下のプロパティを持つ可能性があるオブジェクト。

localeMatcher

使用するロケールマッチングアルゴリズム。使用可能な値は "lookup" および "best fit" で、デフォルトは "best fit" です。このオプションの詳細については、Intl のページを参照ください。

返値

指定したロケールタグのサブセットを表す文字列の配列で、ランタイムのデフォルトロケールにフォールバックすることなくセグメンテーションでサポートされるものです。

supportedLocalesOf() の使用方法

実行環境がリスト形式でインドネシア語とドイツ語をサポートし、バリ語をサポートしないと仮定すると、supportedLocalesOf はインドネシア語とドイツ語の言語タグを変更せずに返します。pinyin の照合順序はインドネシア語のセグメンテーションに関係なく、またインドネシア語に特化したドイツ語はないためサポートされません。ここで "lookup" アルゴリズムの仕様に注意してください。"best fit" マッチでは、バリ島のほとんどの住民がインドネシア語を理解するため、インドネシア語がバリ島の言語に適切に一致すると判断し、バリ島の言語タグも返すことがあります。

js
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.Segmenter.supportedLocalesOf(locales, options).join(", "));
// → "id-u-co-pinyin, de-ID"

仕様書

Specification
ECMAScript Internationalization API Specification
# sec-intl.segmenter.supportedlocalesof

ブラウザーの互換性

BCD tables only load in the browser