Mima Design MemottoWEB DESIGNER · mima

JavaScriptの非同期処理を読みやすく保つ設計術

JavaScriptでアプリやWebサービスを作っていると、通信、ファイル読み込み、ユーザー操作など、完了を待つ処理が頻繁に登場します。処理が少ないうちはコールバック関数でも十分ですが、複数の非同期処理を順番に実行し、さらにエラー処理まで加えると、コードの右方向への深いネストが生まれます。

この状態は一般に「コールバック地獄」と呼ばれます。見た目が複雑になるだけでなく、処理の流れを追いにくく、修正時に思わぬ不具合を招きます。Promiseやasync/awaitの使い分け、関数の責務分離を意識すると、非同期コードはかなり整理できます。

コールバック地獄が起きる理由

コールバックは、ある処理が終わった後に実行する関数を渡す仕組みです。APIからデータを取得し、その結果を使って別のAPIを呼び、さらに画面を更新する場合、処理ごとにコールバックを入れ子にしがちです。

getUser(id, (user) => {
  getPosts(user.id, (posts) => {
    savePosts(posts, (result) => {
      render(result);
    });
  });
});

この書き方では、成功時の処理が深くなるだけでなく、各階層にエラー処理も必要になります。変数の有効範囲や実行順序を確認するために、コードを何度も上下へ移動しなければなりません。

まずは小さな関数へ分ける

既存コードをいきなりPromiseへ書き換える前に、一つのコールバックへ多くの責務を集めないことが重要です。通信、データの整形、保存、表示を別々の関数に分けると、ネストが残っていても処理の意図が見えやすくなります。

エラーを無視して次の処理へ進めるのも避けたいところです。Node.jsでよく使われるエラー・ファースト・コールバックでは、最初の引数にエラーを置き、呼び出し側で即座に扱います。失敗条件を早めに返すだけでも、通常処理のインデントを浅くできます。

Promiseで処理の流れを平らにする

Promiseは、非同期処理の結果が将来確定することを表すオブジェクトです。thenで成功時の処理をつなぎ、catchで失敗をまとめて扱えます。処理を返すことで、次のthenへ値を渡せる点が大きな利点です。

fetchUser(id)
  .then((user) => fetchPosts(user.id))
  .then((posts) => savePosts(posts))
  .then((result) => render(result))
  .catch((error) => showError(error));

Promise.allを使えば、互いに依存しない通信を並列実行できます。すべての処理が成功したときだけ結果を受け取りたい場合に適しています。どれか一つの失敗で全体を止める必要がないなら、Promise.allSettledも候補になります。

書き方ごとの特徴を把握する

プロジェクトでは、古いコールバック形式のAPIとPromise対応のAPIが混在することがあります。すべてを同じ方法へ統一するより、処理の依存関係や既存ライブラリとの相性を見て選ぶ方が現実的です。

方法 読みやすさ エラー処理 向いている場面
コールバック 処理が増えると複雑 各階層で対応 古いAPIや単純な通知
Promise 処理を連結しやすい catchで集約可能 複数の非同期処理
async/await 同期処理に近い try...catch 順序が明確な処理
Promise.all 並列処理に適する 失敗時に全体へ通知 独立した複数リクエスト

比較すると、現在のJavaScriptではPromiseを基盤にし、読みやすさが必要な箇所でasync/awaitを使う構成が扱いやすいでしょう。チーム内で記法をそろえると、レビューや保守もスムーズになります。

async/awaitで同期処理のように書く

async/awaitはPromiseを利用した構文で、非同期処理を上から順番に読める形で記述できます。awaitはPromiseの完了を待ち、その結果を変数へ代入できます。

async function updatePosts(id) {
  try {
    const user = await fetchUser(id);
    const posts = await fetchPosts(user.id);
    const result = await savePosts(posts);
    render(result);
  } catch (error) {
    showError(error);
  }
}

ただし、awaitを無条件に並べると、本来同時に実行できる処理まで直列化してしまいます。独立した処理は先にPromiseを作り、Promise.allで待つと、待ち時間を短縮できます。

UI開発では状態とキャンセルも管理する

画面操作を伴う非同期処理では、通信が終わる前にユーザーが別画面へ移動することがあります。そのまま結果を描画すると、古いリクエストが新しい状態を上書きする競合が起こります。

ローディング中、成功、失敗、キャンセルといった状態を明示し、必要に応じてAbortControllerで通信を中断します。スマートフォン向けアプリやPhoneGapを使った開発では、端末性能や通信環境の差も出やすいため、PhoneGap関連の記事のような実装例を確認しながら、失敗時の画面も設計しておくと安心です。

デバッグしやすい非同期コードにする

非同期処理の不具合は、実行順序が見えにくいことから発生します。各処理の開始と完了、識別子、エラー内容を適切にログへ残すと、どの段階で問題が起きたかを把握できます。開発中だけ詳細ログを出し、本番では個人情報を含めない設計も必要です。

テストでは成功ケースだけでなく、通信失敗、空のレスポンス、タイムアウト、連続クリックも確認します。処理を関数単位に分離しておけば、モックデータを使った検証も容易です。実際の制作メモとして、iPhoneアプリの活用から得られる発想をまとめたアイデアを形に記事のように、日常の操作を観察することもUI改善につながります。

小さく置き換えて保守性を高める

コールバック地獄を解消する作業では、全ファイルを一度に書き換える必要はありません。まず頻繁に変更する処理や、ネストが深い処理を選び、Promise化してからasync/awaitへ移行すると安全です。既存APIがコールバック専用なら、Promiseで包むラッパー関数を用意します。

非同期処理の流れ、エラーの扱い、並列化できる箇所をコードレビューで共有することも効果的です。読みやすい命名と短い関数を意識し、まず一つの画面や機能から改善を始めてください。積み重ねることで、JavaScriptの処理は追いやすく、変更に強いコードへ変わっていきます。