JavaScriptの async / await と fetch の使い方とは?昔のPromise(.then)との違いも解説

JavaScriptの async / await と fetch の解説記事のアイキャッチ

JavaScriptでウェブアプリやサイトを作っていると、サーバーや外部のAPIからデータを取得して画面に表示する場面が出てきますよね。そのときにセットで登場するのが fetch() と async / await です。

私もJavaScriptを勉強し始めたころは、教材に書いてある fetch のコードを見て「async って何?」「なんで await を2回も書くの??」「.then() との違いって……?」と混乱してました。

「普通に上から順番に実行してくれれば分かりやすいのに、なんでこんなヘンな書き方になるの……?」と思っていたんですよね。

でも、昔に使ってた Promise の .then() チェーンと比べると、現在の async / await は直感的で普通のコードとして読める仕組みになっています。この記事では、なぜ async / await が便利なのか、昔の書き方と比較しながら、コンソールで試せる実際のコードと一緒に分かりやすく解説します。

そもそも「非同期処理」ってなに?

JavaScriptは基本的に、コードを上から下へ1行ずつ順番に実行(同期処理)していきます。

しかし、外部のサーバーからデータを取得するような通信処理は、結果が返ってくるまでにコンマ数秒〜数秒の「待ち時間」が発生します。もし通信が終わるまでJavaScript全体の処理をストップしてしまうと、その間ユーザーはボタンを押すことも画面をスクロールすることもできなくなってしまいます。

そこでJavaScriptは、「重い通信処理はバックグラウンドに任せて、待っている間に他の処理を進める」という仕組みをとっています。これが非同期処理です。

簡単なコードで「非同期」を体感してみよう

言葉だけだとイメージしにくいので、指定した時間だけ処理を遅らせる setTimeout を使って実験してみましょう。

ブラウザのデベロッパーツール(開発ツール)のタブにあるコンソールで以下のコードを実行してみてください。

console.log('A. 処理スタート');

// 3秒(3000ミリ秒)待ってから実行するタイマー処理(非同期処理)
setTimeout(() => {
  console.log('B. 3秒経ちました!(通信完了のイメージ)');
}, 3000);

// タイマーが終わるのを待たずに、先にこちらの行が実行される
console.log('C. 次の処理へ進みます');

// 実際の出力順:
// A. 処理スタート
// C. 次の処理へ進みます
// B. 3秒経ちました!(通信完了のイメージ)

コードの見た目は上から A → B → C の順番で書いているのに、実際の出力は A → C → B の順番になりましたよね!

これが非同期処理の大きな特徴です。B の3秒間の待ち時間を待つことなく、JavaScriptが先に C の処理を進めてくれているわけです。

ですが、もし「B で取得したデータを使って C を実行したい」という場合は、このままでは困ってしまいますよね。そこで「B の完了をちゃんと待ってから次へ進む」ために使うのが、今回解説する async / await です。

昔の書き方(.then)と今の書き方(async / await)の比較

非同期処理が終わったあとにデータを受け取る方法として、昔は Promise という仕組みの .then() メソッドをいくつもつなげて書くのが主流でした。

実際の挙動を試すために、無料のテスト用APIからユーザーデータを1件取得するコードを動かしてみましょう。

昔の書き方:.then() チェーン

// 昔の主流:.then() をつなげて処理を書く
fetch('https://jsonplaceholder.typicode.com/users/1')
  .then((response) => {
    return response.json();
  })
  .then((data) => {
    console.log('ユーザー名:', data.name);
  })
  .catch((error) => {
    console.error('エラー発生:', error);
  });

この書き方でも動きますが、処理が増えるたびに .then(...) の中に無名関数を渡す必要があり、カッコやインデントが深くなってコードの流れを追うのが大変になります。

今の書き方:async / await

まったく同じ処理を、モダンな async / await で書き直すと次のようになります。

// 今の主流:async / await で書く
async function getUser() {
  try {
    const response = await fetch('https://jsonplaceholder.typicode.com/users/1');
    const data = await response.json();
    console.log('ユーザー名:', data.name);
  } catch (error) {
    console.error('エラー発生:', error);
  }
}

getUser();
// コンソール出力:ユーザー名: Leanne Graham

見た目が一気にスッキリしましたね!

まるで普通の同期処理のコードと同じように、「データを取得して、JSONに変換して、ログに出す」という流れが上から下へ素直に読めるのが async / await 最大のメリットです。

なんで await を2回書くの?

コードを見て「なんで const response = await fetch(...) と const data = await response.json() で2回も await が出てくるの?」と疑問に思った方もいるかもしれません。

実は、通信処理では 「2段階の待ち時間」 が発生しているからです。

  1. 1回目の await(fetch): サーバーから返事(レスポンス)が届くまで待つ
  2. 2回目の await(response.json()): 届いたデータの中身(JSON)をJavaScriptのオブジェクトに変換し終わるまで待つ

この2ステップそれぞれで待つ必要があるため、await を2個書いています。

ここがポイント!ルールは2つだけ

  • async: 非同期処理(await)を含んでいる関数宣言の先頭につける(「この関数の中では非同期処理を使いますよ」というサイン)
  • await: 処理の完了を待ちたい非同期処理(fetch など)の直前につける(「結果が返ってくるまでここで少し待ってね」という指示)

初心者がハマりがちなミスと対処法

async / await を使い始めるときに、誰もが一度は遭遇する定番のエラーや罠があります。

罠1:await をつけ忘れて Promise { <pending> } になる

fetch() はデータを即座に返すのではなく、「将来データが手に入る約束(Promise)」を返します。そのため await を付け忘れると、まだ通信中の状態のまま変数に代入されてしまいます。

async function test() {
  // await を付け忘れた!
  const response = fetch('https://jsonplaceholder.typicode.com/users/1');
  
  console.log(response);
  // 出力:Promise { <pending> }(通信待ち状態のまま中身が見えない!)
}

test();

コンソールに Promise { <pending> } と表示されたときは、「あ、fetch や .json() の前に await をつけ忘れているな」とチェックしましょう。

罠2:fetch() は 404 エラーでも catch に入らない

fetch() のもう1つの有名な注意点として、指定したURLが存在せず「404 Not Found」や「500 Server Error」になっても、通信自体が成功していれば catch ブロックへジャンプしないという性質があります。

確実にエラーを検知するためには、response.ok というプロパティを使って自分で判定するのが安全です。

async function getSafeData() {
  try {
    const response = await fetch('https://jsonplaceholder.typicode.com/users/99999');

    // レスポンスが正常(ステータスコード 200〜299)でない場合はエラーを投げる
    if (!response.ok) {
      throw new Error(`HTTPエラー! ステータス: ${response.status}`);
    }

    const data = await response.json();
    console.log(data);
  } catch (error) {
    console.error('取得に失敗しました:', error.message);
  }
}

getSafeData();

React開発での活用例

Reactのコンポーネント内でボタンをクリックしたときにデータを取りに行く処理も、async / await を使えばとても直感的に書くことができます。

テンプレートリテラル を使ってURLに変数(IDなど)を埋め込み、取得したデータを State(状態)に保存するのがよくあるパターンです。

import { useState } from 'react';

function UserButton() {
  const [user, setUser] = useState(null);
  const [loading, setLoading] = useState(false);

  // ボタンを押したときに実行する関数
  const fetchUser = async (userId) => {
    setLoading(true);
    try {
      // テンプレートリテラルで動的にURLを作る
      const response = await fetch(`https://jsonplaceholder.typicode.com/users/${userId}`);
      const data = await response.json();
      setUser(data);
    } catch (error) {
      console.error('データの取得に失敗しました', error);
    } finally {
      setLoading(false);
    }
  };

  return (
    <div>
      <button onClick={() => fetchUser(1)} disabled={loading}>
        {loading ? '読み込み中...' : 'ユーザー情報を取得'}
      </button>

      {/* 真偽値判定(Truthy / Falsy)でデータがあるときだけ表示 */}
      {user && (
        <div>
          <h3>{user.name}</h3>
          <p>Email: {user.email}</p>
        </div>
      )}
    </div>
  );
}

finally ブロックを使うと、通信が成功したか失敗したかにかかわらず、最後に必ず setLoading(false) を実行してローディング表示を解除できるので覚えておくと便利です。

なお、この例で使っている {user && (...)} という表示の切り替えは、値の真偽判定と && の短絡評価を組み合わせた書き方です。詳しくは Truthy と Falsy の記事 と 論理演算子(&& と ||)の記事 で解説しています。

まとめ

  • 非同期処理: 重い通信処理が終わるのを待つ間に、他の処理を止めないための仕組み
  • async / await: 昔の .then() チェーンよりもコードを上から下へ素直に読めるようにした構文
  • await を2回書く理由: レスポンス待ち(通信)とデータ変換待ち(JSON化)の2段階があるため
  • await の忘れ: つけ忘れると Promise { <pending> } になるので注意
  • エラーハンドリング: try / catch で囲み、response.ok でステータスコードをチェックするのが安全

外部APIからデータを取り出せるようになると、作れるアプリの幅が広がります。まずはブラウザのコンソールで fetch してみることから試してみてくださいね!

コメント

タイトルとURLをコピーしました