API呼び出し

Webアプリケーションでは、外部サービスと通信してデータをやり取りする場面が頻繁に出てきます。ブラウザから他のサーバへHTTPリクエストを送る仕組みが fetch API です。通信には時間がかかるため、他の処理を止めずに結果を待つ 非同期処理 の考え方も一緒に必要になります。本セクションでは、fetch の基本形からPromise・async / await・try / catch・Promise.allまでを、httpbin.org の各エンドポイントを呼び出しながら順に扱います。

📝 httpbin.orgとは
httpbin.org は、HTTPリクエストの動作確認を目的として公開されている無料のテスト用サービスです。GET・POST・遅延レスポンス・エラー応答など、さまざまなエンドポイントを提供しています。本章では、本物のバックエンドAPIの代役として、通信の動作を試すために利用します(このように、本物の代わりに使う仮のAPIを スタブ と呼びます)。

1. 同期処理と非同期処理

コードの実行方式には 同期処理 と 非同期処理 の2種類があります。同期処理は、1つの処理が終わってから次の処理に進む方式です。ファイル読み込みやAPI通信のように時間のかかる処理を同期で行うと、その間ブラウザは他の操作を受け付けられなくなり、画面が固まってしまいます。

非同期処理 は、時間のかかる処理を裏で走らせつつ、他の処理を並行して進められる仕組みです。JavaScriptには、非同期処理の完了を表す Promise(プロミス)という仕組みが標準で用意されており、fetch などブラウザ組み込みの通信APIはすべてPromiseを返します。

本セクションの以降では、この Promise を fetch を題材に扱いながら、非同期処理を中心に、基本の書き方から、より簡潔な書き換え、エラーの捕捉、複数通信の並行実行まで、順に試します。

2. fetchによるデータ取得

外部サーバへHTTPリクエストを送り、レスポンスを受け取るときは fetch 関数を使います。書き方は以下のとおりです。

fetch("URL");

fetch の戻り値は「HTTPレスポンス」を表すPromiseです。Promiseは「今はまだ結果が確定していないが、いずれ確定する値」を表すオブジェクトで、成功時と失敗時の処理を .then() / .catch() のチェーンで書けます。書き方は以下のとおりです。

Promiseを返す関数().then((値) => 成功時の処理).catch((エラー) => 失敗時の処理);

これは、httpbin.org/uuid から一意なUUID文字列を取得し、ポップアップで表示するコードです。app.js を以下の内容で上書き保存します。

const button = document.querySelector("#btn");

button.addEventListener("click", () => {
  fetch("https://httpbin.org/uuid")
    .then((response) => response.json())
    .then((data) => alert(JSON.stringify(data, null, 2)))
    .catch((error) => alert("エラー: " + error.message));
});

ブラウザで index.html を再読み込みし、「クリック」ボタンを押すと、以下のようなポップアップが表示されます(uuid の値は毎回変わります)。

「このページの内容」のタイトルの下に、uuid プロパティを含む JSON がインデント付きで表示されました。ボタンを押すたびに毎回異なる uuid の値が返ってきていることが動作確認のポイントで、httpbin.org/uuid への通信が成立し、.then のチェーンで レスポンス取得 → JSON への変換 → 表示 と順に非同期処理をつなげられていることが確認できます。

コードを解説します。

fetch("https://httpbin.org/uuid")

fetch が返すPromiseは、Response オブジェクトへ解決されます。Response はHTTPステータスやレスポンスヘッダなどを含むオブジェクトで、実際のボディはこの段階ではまだ読み出せていません。

.then((response) => response.json())

response.json() はレスポンスボディをJSONとして解釈する関数で、こちらもPromiseを返します。.then の中でPromiseを返すと、次の .then はそのPromiseの解決を待って呼ばれます。

.then((data) => alert(JSON.stringify(data, null, 2)))

JSONから変換されたJavaScriptオブジェクトを、JSON.stringify() の第3引数 2 でインデント2スペースの整形付き文字列に変換してポップアップ表示しています。alert() はオブジェクトを直接渡すと [object Object] としか表示されないため、JSON.stringify() で文字列化してから渡します。

.catch((error) => alert("エラー: " + error.message));

途中のどこかでPromiseが失敗(reject)になると、.catch に登録した関数がエラーオブジェクトを受け取って呼ばれます。ネットワーク切断など、通信そのものが失敗したときの受け皿になります。

3. async / awaitへの書き換え

.then のチェーンでも動作は問題ありませんが、通信を複数回連続で行う場合はネストが深くなり読みづらくなります。同じ非同期処理を、同期処理と同じ見た目で書ける仕組みが async / await です。書き方は以下のとおりです。

const 関数名 = async () => {
  const 値 = await Promiseを返す関数();
  // 値を使った処理
};

async を付けた関数の中では await が使えます。await は「Promiseが解決するまで一時停止し、解決した値を返す」動作をします。書き換えると、.then のコールバックが「変数への代入」と同じ見た目になります。

これは、先ほどの fetch の例をasync / awaitで書き換えたコードです。app.js を以下の内容で上書き保存します。

const button = document.querySelector("#btn");

const fetchUuid = async () => {
  const response = await fetch("https://httpbin.org/uuid");
  const data = await response.json();
  alert(JSON.stringify(data, null, 2));
};

button.addEventListener("click", fetchUuid);

ブラウザで index.html を再読み込みし、「クリック」ボタンを押すと、.then チェーン版と同じく以下のようなポップアップが表示されます。

「このページの内容」のタイトルの下に、uuid プロパティを含む JSON がインデント付きで表示されました。.then チェーン版と同じ結果が得られていることが動作確認のポイントで、.then を 1 つも書かずに、上から順に読める形で通信結果を受け取れています。処理内容は同じでも、フローの見通しが大きく改善されていることが分かります。

コードを解説します。

const fetchUuid = async () => {

async を関数に付けると、その関数の戻り値は自動的にPromiseで包まれ、内部で await が使えるようになります。

const response = await fetch("https://httpbin.org/uuid");
const data = await response.json();

await を付けると、Promiseの解決を待ってから解決値を受け取れます。上の2行は .then((response) => response.json()).then((data) => ...) と同じ意味ですが、書き方は変数への代入と同じ形になっています。

4. try / catchでのエラー捕捉

JavaScriptには、実行中に発生したエラーを捕まえて処理を続けるための try / catch という構文が用意されています。try ブロックの中で発生したエラーは、続く catch ブロックに引き渡され、そこで受け取って処理できます。async / awaitで書いた非同期処理のエラーも、この try / catch で捕捉できます。書き方は以下のとおりです。

try {
  await Promiseを返す関数();
} catch (error) {
  // エラー時の処理
}

await の対象がrejectされた場合や、await 中に例外が投げられた場合は、すべて catch ブロックに流れます。エラーオブジェクトの message プロパティで、失敗の内容を文字列として取り出せます。

これは、存在しないURLへアクセスしてエラーを発生させ、try / catch で捕捉するコードです。app.js を以下の内容で上書き保存します。

const button = document.querySelector("#btn");

const fetchInvalid = async () => {
  try {
    const response = await fetch("https://invalid.example.invalid/data");
    const data = await response.json();
    alert(JSON.stringify(data, null, 2));
  } catch (error) {
    alert("エラー: " + error.message);
  }
};

button.addEventListener("click", fetchInvalid);

ブラウザで index.html を再読み込みし、「クリック」ボタンを押すと、以下のようなポップアップが表示されます(メッセージの文言はブラウザによって多少異なります)。

「このページの内容」のタイトルの下に「エラー: Failed to fetch」のメッセージが表示されました。存在しないドメインへの通信が失敗しても JavaScript が停止せず、catch ブロックのエラーメッセージがポップアップに出ていることが動作確認のポイントで、try / catch で囲むことで await 中の失敗を1箇所にまとめて処理できることが確認できます。

⚠️ 「エラー: Failed to fetch」が表示されず、CORSエラーになる場合
ブラウザによっては、DevToolsのConsoleに Access to fetch at ... has been blocked by CORS policy のようなCORSエラーが先に表示される場合があります。CORSエラーの結果として fetch のPromiseがrejectされるため、catch ブロックは同じように呼ばれます。表示されるメッセージが違っていても、動作としては同じです。

コードを解説します。

try {
  const response = await fetch("https://invalid.example.invalid/data");
  const data = await response.json();
  alert(JSON.stringify(data, null, 2));
} catch (error) {
  alert("エラー: " + error.message);
}

try ブロックには通常の処理を書き、await の対象がrejectされたときや、途中で例外が投げられたときに catch ブロックへ制御が移ります。Error オブジェクトの message プロパティに、失敗の内容が文字列として入っています。

5. Promise.allによる並行実行

複数の非同期処理を 並行に 実行し、すべての完了を待ちたい場合は Promise.all を使います。書き方は以下のとおりです。

const 結果配列 = await Promise.all([Promise1, Promise2, Promise3]);

Promise.all は渡された配列の要素をすべて並行に開始し、全部が解決するのを待って結果の配列を返します。1つでも失敗するとPromise全体が失敗扱いになる点は、後述の補足で扱います。

これは、httpbin.org/delay/1(1秒後にレスポンスを返すエンドポイント)を3つ並行に呼び出し、実行時間を測定するコードです。app.js を以下の内容で上書き保存します。

const button = document.querySelector("#btn");

const fetchAll = async () => {
  const start = performance.now();
  const responses = await Promise.all([
    fetch("https://httpbin.org/delay/1"),
    fetch("https://httpbin.org/delay/1"),
    fetch("https://httpbin.org/delay/1"),
  ]);
  const elapsed = (performance.now() - start) / 1000;
  alert(`3件取得完了: ${responses.length}件、経過時間 ${elapsed.toFixed(2)}秒`);
};

button.addEventListener("click", fetchAll);

ブラウザで index.html を再読み込みし、「クリック」ボタンを押すと、以下のようなポップアップが表示されます(経過時間の数値は環境によって変動します)。

「このページの内容」のタイトルの下に「3件取得完了: 3件、経過時間 X.XX秒」の形でポップアップが表示されます。3件のリクエストが並行に開始され、すべての完了をまとめて 1 回の await で待てていることが動作確認のポイントで、Promise.all に渡した配列の要素がそれぞれ並行実行されていることが確認できます。1件ずつ直列に await した場合は3件×1秒+通信オーバーヘッドで少なくとも 3 秒以上かかるところ、並行実行では最も遅い1件分の時間 + オーバーヘッド程度で完了するため、通信時間を大きく短縮できます(ネットワーク状況やサーバ側の応答速度によっては、直列との差が縮まって見える場合もあります)。

コードを解説します。

const start = performance.now();

performance.now() は、ページ読み込みからの経過時間をミリ秒単位で返すブラウザ組み込みの関数です。処理開始時刻を控えるために使っています。

const responses = await Promise.all([
  fetch("https://httpbin.org/delay/1"),
  fetch("https://httpbin.org/delay/1"),
  fetch("https://httpbin.org/delay/1"),
]);

配列に渡した3つの fetch は、Promise.all に渡した時点で並行して開始されます。await は3件すべての解決を待ってから、Response オブジェクトの配列を返します。

const elapsed = (performance.now() - start) / 1000;
alert(`3件取得完了: ${responses.length}件、経過時間 ${elapsed.toFixed(2)}秒`);

処理完了時の時刻から開始時刻を引き、ミリ秒を秒に直して表示しています。toFixed(2) で小数第2位までに整形しています。

💡 ポイント
Promise.all は1つでも失敗するとすべてが失敗扱いになります。1件の失敗で他の結果まで捨てたくない場合は、Promise.allSettled を使うと成功・失敗を含めた結果配列を得られます。