Intl.Collator.supportedLocalesOf()

Intl.Collator.supportedLocalesOf() メソッドは、ランタイムの既定のロケールで代替しなくても照合で対応するロケールを含む配列を返します。

構文

Intl.Collator.supportedLocalesOf(locales[, options])

引数

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

省略可能です。以下のプロパティを持つことがあるオブジェクトです。

localeMatcher
使用するロケールの一致アルゴリズムです。指定可能な値は lookup および best fit で、既定値は best fit です。このオプションの詳細は、 Intl のページを参照してください。

返値

指定したロケールタグのサブセットを表す文字列の配列で、ランタイムの既定のロケールで代替する必要なく複数形の書式で対応されているものを含みます。

解説

locales で指定されている言語タグのサブセットを含む配列を返します。返される言語タグは、ランタイムがロケールの照合に対応しているもので、使用しているロケール一致アルゴリズムが、既定のロケールで代替することなく一致するとみなすものです。

Examples

Using supportedLocalesOf

インドネシア語とドイツ語に対応しているもの、バリ語に対応していないランタイムを想定すると、ピンインの照合がインドネシア語では使用されておらず、インドネシアに特化したドイツ語がサポートされている可能性が低いとしても、 supportedLocalesOf はインドネシア語とドイツ語の言語タグを変更せずに返します。これは lookup アルゴリズムの仕様であること注意してください。 best fit マッチャーは、ほとんどのバリ語話者がインドネシア語も理解しているので、インドネシア語がバリ語に適切であると判断し、バリ語の言語タグも返すかもしれません。

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

仕様書

ブラウザーの互換性

BCD tables only load in the browser

関連情報