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

Intl.ListFormat.supportedLocalesOf()メソッドは、JavaScriptの国際化APIであるIntlオブジェクトが提供するListFormat機能において、指定されたロケールの中から実際にサポートされているロケールを特定し、その一覧を配列として返すメソッドです。Intl.ListFormatは、複数の項目を結合して「A、B、およびC」のように、それぞれの言語や地域の慣習に合わせたリスト形式の文字列を生成するために使用されます。

このsupportedLocalesOf()メソッドは、Webアプリケーションやシステムがどのロケールでリスト整形機能を適切に実行できるかを確認する際に非常に重要です。例えば、アプリケーションが複数の言語に対応しており、ユーザーが利用したいロケールを指定した場合に、そのロケールがJavaScriptの実行環境によって適切に処理可能かどうかを事前に確認できます。開発者は、対応したいロケールを表す文字列の配列をこのメソッドに引数として渡し、返された配列を参照することで、実際にサポートされているロケールのみを利用することができます。

これにより、未サポートのロケールを指定してリスト整形を試みた際に発生しうるエラーや、意図しない結果を防ぐことが可能になります。国際化対応が求められるシステム開発において、ユーザーエクスペリエンスを向上させ、ロケールごとの表現の差異に適切に対応するための基盤となる情報を提供する、非常に有用なツールと言えます。

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

locales, options

• locales: Array<string> | string | undefined: サポートされているロケールを配列または単一の文字列で指定します。指定しない場合は、実行環境のデフォルトロケールが使用されます。
• options: Intl.ListFormatOptions | undefined: フォーマットのオプションを指定します。

Array<string>

Intl.ListFormat.supportedLocalesOf()は、指定されたロケールのうち、Intl.ListFormatでサポートされているロケールを文字列の配列として返します。