【JavaScript ECMAScript】Intl::Intl.NumberFormat.supportedLocalesOf静的メソッドの使い方
Intl.NumberFormat.supportedLocalesOf()静的メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Intl.NumberFormat.supportedLocalesOf()メソッドは、指定されたロケール識別子のリストの中で、JavaScriptの国際化APIであるIntl.NumberFormatオブジェクトが実際に数値をフォーマットできるロケールを特定し、そのリストを返すメソッドです。このメソッドは、国際化されたアプリケーションを開発する際に、特定の実行環境でどのような言語や地域の数値表現がサポートされているかを正確に知りたい場合に非常に有用です。
引数には、サポート状況を調査したい一つまたは複数のロケール識別子（例えば 'en-US' や 'ja-JP' など）を、文字列または文字列の配列として渡します。オプションとして、ロケールのマッチング方法を制御するオブジェクトを指定することも可能です。
戻り値としては、入力されたロケールのうち、Intl.NumberFormatコンストラクターがエラーなく利用できると判断したロケール識別子のみを含む新しい配列が返されます。この結果の配列内のロケールは、元の引数で指定された順番が維持されます。これにより、開発者はアプリケーションが利用可能なロケールに基づいた適切な数値フォーマットを確実に提供できるようになります。例えば、ユーザーのブラウザが特定のロケールをサポートしていない場合でも、このメソッドを用いることで代替のロケールを選定したり、サポートされているロケールのみをユーザーに提示したりすることが可能となり、より堅牢な国際化対応アプリケーションの構築に貢献します。
構文(syntax)
1Intl.NumberFormat.supportedLocalesOf(['en-US', 'de-DE', 'fr-FR']);
引数(parameters)
locales, options
- locales: string[] | string: サポートされているロケールを指定する文字列または文字列の配列
- options: Intl.NumberFormatOptions: フォーマットのオプションを指定するオブジェクト
戻り値(return)
Array<string>
指定されたロケールが Intl.NumberFormat でサポートされているかどうかを示す文字列の配列を返します。