【JavaScript ECMAScript】Intl::Intl.RelativeTimeFormat.supportedLocalesOf静的メソッドの使い方
Intl.RelativeTimeFormat.supportedLocalesOf()静的メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Intl.RelativeTimeFormat.supportedLocalesOf()メソッドは、Intl.RelativeTimeFormatオブジェクトが相対時間の書式設定をサポートするロケールを判定するために実行するメソッドです。このメソッドは、引数として指定されたロケール識別子の配列の中から、現在のJavaScript実行環境が実際に相対時間書式設定に対応しているものを判別し、その有効なロケールの配列を返します。
システムエンジニアを目指す初心者の方々にとって、このメソッドはWebアプリケーションやシステムの国際化対応（i18n）において非常に重要な役割を果たします。例えば、アプリケーションが複数の言語に対応している場合、ユーザーが希望する言語環境としていくつかのロケール（例: "fr-CA", "en-US", "ja-JP"）を指定することがあります。このメソッドを使用することで、開発者は指定されたロケールの中から、実際にシステムがサポートしているものだけを効率的に抽出できます。これにより、サポートされていないロケールが指定された場合に適切なフォールバック処理を実装したり、ユーザーに対して利用可能な言語の選択肢を正確に提示したりすることが可能になります。
メソッドの第1引数には、チェックしたいロケール識別子の配列を指定します。第2引数には、オプションのオブジェクトを指定することができ、ロケール解決アルゴリズム（例えば、localeMatcherプロパティ）を設定することで、より詳細なマッチング制御が可能です。戻り値として得られる配列は、元の指定順序を維持しつつ、現在の実行環境でサポートされているロケールのみを含みます。この機能により、多言語対応のアプリケーション開発において、特定の言語環境に依存しない堅牢なロケール選択ロジックを構築することができます。
構文(syntax)
1Intl.RelativeTimeFormat.supportedLocalesOf(locales, options);
引数(parameters)
locales, options
- locales: string[] | string: サポートされているロケールを指定する文字列または文字列の配列
- options: Intl.RelativeTimeFormatOptions: オプションを指定するオブジェクト
戻り値(return)
Array<string>
指定されたロケールが、Intl.RelativeTimeFormat でサポートされているロケールの配列を返します。