Intl.Collator.supportedLocalesOf()

概要

ランタイムデフォルトローケルに戻る必要なしで、サポートされている提供されているローケルを含んでいる配列を返します。

構文

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

引数

locales

BCP47言語タグをもった文字列、そのような文字列の。 locales引数の一般的な形式に対して、Intl pageを確かめて下さい。

options

任意。次のプロパティを持つオブジェクト:

localeMatcher

使用しているローケルマッチングアルゴリズム。 可能な値は"lookup" や "best fit"です。; デフォルトは"best fit"です。このオプションの情報に対して、Intl pageを確かめて下さい。

説明

localesで提供されている言語タグのサブセットをもった配列を返します。返される言語タグでは、ランタイムが、をローケルマッチングアルゴリズムの使用のローケルをサポートし、ふさわしいものを考慮しているので、デフォルトローケルに戻る必要はありません。

例

例: 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"

仕様

ブラウザ実装状況

関連情報

• Intl.Collator