【JavaScript ECMAScript】Intl::Intl.PluralRules.supportedLocalesOf静的メソッドの使い方

Intl.PluralRules.supportedLocalesOf()メソッドは、指定されたロケール（言語や地域の情報）が現在のJavaScript実行環境でIntl.PluralRules機能としてサポートされているかを確認し、サポートされているロケールのリストを返すメソッドです。Intl.PluralRulesは、国際化APIの一部であり、数値の複数形ルールを扱います。例えば、英語では「1 item」と「2 items」のように数が変わると名詞の形も変わることがありますが、このような言語ごとの複雑なルールに対応するために使用されます。

このメソッドは、引数としてロケール識別子（例: 'en-US', 'ja-JP'）の配列を受け取ります。もし引数を省略した場合、現在の実行環境がIntl.PluralRulesで処理できるすべてのサポート対象ロケールを返します。引数に複数のロケールを渡すと、その中から実際にシステムがサポートしているロケールのみを抽出し、そのリストを新しい文字列配列として返します。

この機能は、アプリケーションが特定の言語や地域のユーザーに対応する際に非常に役立ちます。例えば、ユーザーがアプリケーションの言語設定を変更しようとしたとき、その言語が本当にシステムで複数形ルールを正しく適用できるのかを事前に確認できます。これにより、開発者は、対応するロケールを効率的に特定し、アプリケーションの国際化品質を向上させることが可能になります。戻り値は、利用可能なロケール識別子の文字列配列です。

Copy
1Intl.PluralRules.supportedLocalesOf(locales[, options]);

locales, options = {}

• locales: string[] | string: サポートされているロケールを指定する配列または文字列
• options: Intl.PluralRules.PluralRulesOptions = {}: プラグマティックなオプションを指定するオブジェクト

Array<string>

指定されたロケールのうち、PluralRulesでサポートされているロケールの配列を返します。