【ITニュース解説】Promise Hashes

システム開発において、ネットワーク通信やデータベースアクセス、ファイル読み込みなど、完了までに時間がかかる処理は多く存在する。これらの処理を一つずつ順番に待っていたのでは、アプリケーション全体の動作が遅くなり、ユーザー体験を損ねてしまう。そこで、これらの時間のかかる処理を「非同期」で実行し、完了を待たずに次の処理へ進めることが重要となる。JavaScriptでは、この非同期処理をより効率的かつ安全に扱うための仕組みとして、「Promise（プロミス）」が提供されている。

Promiseは、未来のある時点で結果（成功または失敗）が判明する処理を表現するオブジェクトだ。Promiseには「保留（Pending）」「解決（Fulfilled）」「拒否（Rejected）」の三つの状態がある。非同期処理が開始されるとPromiseは保留状態となり、処理が成功すれば解決状態へ、失敗すれば拒否状態へと変化する。解決された結果は.then()メソッドで受け取ることができ、拒否された理由（エラー）は.catch()メソッドで捕捉できる。これにより、非同期処理の完了後の流れを順序立てて記述することが可能となる。

複数の非同期処理を並行して実行し、全ての処理が成功するまで待ち、その結果をまとめて受け取りたい場合、「Promise.all()」という非常に便利なPromiseメソッドが利用される。Promise.all()はPromiseオブジェクトの配列を引数として受け取り、配列内の全てのPromiseが解決されると、それぞれの結果を元の配列の順序で格納した新しい配列を返す。もし、一つでもPromiseが拒否されると、Promise.all()全体も拒否され、最初に拒否されたPromiseの理由が返される仕組みになっている。

しかし、Promise.all()には一つの課題がある。それは、引数も結果も配列であるという点だ。例えば、Webフォームの表示に必要なアプリケーション設定、多言語対応のフォーマット情報、地域の文字列、ユーザー権限、フォームの入力規則といった複数の情報を非同期で取得する場合、これらのPromiseをPromise.all()に配列として渡すことになる。そして、Promise.all()が返した結果の配列は、0番目の要素がアプリケーション設定、1番目が多言語対応情報…というように、その意味を開発者がインデックス（配列の何番目の要素か）で管理する必要がある。

このインデックスによる管理は非常に脆い。もし後から新しい情報（例えば管理者権限）の取得処理を追加したり、既存の処理の順番を入れ替えたりすると、.then()で結果を受け取る側のコードで使われているインデックスも全て修正しなければならない。インデックスがずれると、間違ったデータを使って処理が実行されてしまい、予期せぬバグや動作不良の原因となる。これは開発者にとって保守が困難で、エラーを引き起こしやすいパターンであり、コードの可読性も損なわれがちである。

このような課題を解決し、より堅牢で直感的な非同期処理の連携を実現するため、「Promise.hash()」という新しいアプローチが提案されている。これは、Promise.all()が配列の代わりに「オブジェクト」（他の言語ではハッシュマップや連想配列とも呼ばれる、キーと値のペアでデータを管理する構造）を受け取るイメージだ。具体的には、キーが非同期処理の名前、値がその処理を実行するPromiseであるようなオブジェクトをPromise.hash()に渡す。

そして、全てのPromiseが解決された後、Promise.hash()は、元のキーをそのまま使い、そのキーに対応する非同期処理の結果を値として持つ新しいオブジェクトを返す。この仕組みにより、開発者は結果をインデックスではなく、直感的な「キー名」で参照できるようになる。例えば、perms.userやperms.postのように、意味のある名前でデータにアクセスできるため、コードの可読性が格段に向上し、変更に強い堅牢なコードを書けるようになるのだ。

このPromise.hash()の概念は、JavaScriptの既存の機能を使って比較的簡単に実装できる。その要件は以下の通りだ。

1. Promiseを値に持つオブジェクト（これを「Promiseハッシュ」と呼ぶ）を受け取る。
2. 受け取ったPromiseハッシュの値（Promiseオブジェクト、または通常のJavaScriptの値）を抽出し、それらをPromise.all()に渡す。
3. Promise.all()が成功した場合、その結果の配列を、元のPromiseハッシュのキーと対応付けて、新しいオブジェクト（これを「値ハッシュ」と呼ぶ）として返す。
4. Promise.all()が拒否された場合、その拒否をPromise.hash()全体もそのまま伝える。
5. 最終的に、この処理全体がPromiseチェーンとして機能するように、Promiseを返す。

具体的な実装手順としては、まずpromiseHashという関数を定義し、引数としてinputHash（Promiseハッシュ）を受け取る。次に、Object.values(inputHash)という組み込みメソッドを使って、inputHashオブジェクトから値だけを抽出し、その値の配列をPromise.all()に渡す。この際、Promise.all()はPromiseオブジェクトだけでなく、通常のJavaScriptの値も即座に解決されたPromiseとして扱う柔軟性を持っているため、入力値がPromiseでなくても問題なく処理される。

Promise.all()が成功すると、その結果は.then()メソッドで配列として受け取れる。この時点で、元のinputHashのキーをObject.keys(inputHash)で取得し、結果の配列と対応付ける。これらのキーと結果のペアをmap()メソッドを使って[キー, 値]の形式の配列（エントリー）に変換し、最後にObject.fromEntries()というメソッドを使って、これらのエントリーから新しいオブジェクトを作成する。これが、求めていた「値ハッシュ」となる。この一連の処理をPromiseチェーンとしてreturnすることで、promiseHash関数自体がPromiseを返すようになる。

さらに堅牢性を高める工夫もある。上記の実装では、最初に値、次にキーを別々に取得しているが、この間に元のinputHashオブジェクトが変更されると、キーと値の対応がずれてしまう可能性がごく稀に発生する。これを防ぐためには、Object.entries(inputHash)を使って、キーと値のペアを一度に全て抽出し、そのエントリーからキーの配列と値の配列をそれぞれ生成する方法が推奨される。これにより、処理中に元のオブジェクトが変更されても、キーと値の対応が常に保証され、より安定したコードとなる。

Promise.hash()は、Promise.all()のインデックス管理が引き起こす問題を見事に解決する。例えば、ユーザーの権限情報を取得する際に、Promise.all()で配列として取得し、結果を配列の分割代入で受け取るようなコードは、要素の追加や並び替えによって容易に壊れてしまう。しかし、Promise.hash()を使えば、キー名で結果にアクセスするため、新しい要素を追加しても、既存のキーでアクセスする部分は影響を受けず、コードの変更に強く、保守性が大幅に向上する。

また、Promise.all()は一つでもPromiseが拒否されると全体が拒否されてしまうが、全てのPromiseの完了を待って、個々の結果（成功か拒否か）をオブジェクトとして取得したい場合には、「Promise.allSettled()」を利用できる。Promise.hash()の内部でPromise.all()の代わりにPromise.allSettled()を使うことで、同じようにキーと結果を対応付ける「promiseSettledHash」のような関数も簡単に作成可能だ。さらに、promiseHash関数にオプション引数を追加することで、Promise.all()とPromise.allSettled()のどちらを使うかを呼び出し元で選択できるようにすることもでき、より汎用性の高い非同期処理のヘルパー関数を提供できる。

このように、Promise.hash()は、JavaScriptの非同期処理において、複数のPromiseの結果を名前付きで管理したい場合に非常に有効なツールとなる。Promise.all()が持つ配列インデックス管理の脆さを克服し、コードの可読性、保守性、そして堅牢性を大きく向上させることが期待される。JavaScriptの組み込みメソッドを組み合わせるだけで比較的簡単に実装でき、開発体験を大きく改善する可能性がある。