本文へ移動
プログラミング大全動かして、比べて、理解する。

コードを書き、予想と実際の出力を比べて学ぶJavaScript入門です。コード・ノート・回答履歴は、このブラウザーへ必要なときだけ保存できます。

本文と固定例は読めます。編集・自己確認・保存は「学習機能を準備」から使えます。

JavaScript入門 / 単元 8

JavaScriptのPromiseとasync/await — 結果を待ち、失敗を扱う

Promiseは、まだ決まっていない結果を扱うための値です。async関数とawaitで結果を受け取り、try/catchで失敗を分けます。通信を使わない固定例で、待つ場所と処理の順序を確かめます。

前提:関数

この単元でできるようになること

  • Promiseの待機・成功・失敗を区別する
  • async関数の戻り値をawaitで受け取る
  • awaitで中断する範囲と、外側の処理の順序を説明する
  • 拒否されたPromiseをtry/catchで扱う
  • 前の結果に依存する処理と、独立した処理をまとめて待つ方法を使い分ける
  • thenのreturn忘れとforEachの待機の落とし穴を説明する

結果そのものと、結果を表すPromiseを分ける

Promiseの状態は、待機中のpending、成功のfulfilled、失敗のrejectedです。成功すると値、失敗すると理由を持ちます。一度確定した状態は、別の結果へ変わりません。

Promise.resolve(12)は値12を成功結果に持つPromiseを作ります。awaitでその結果を受け取れます。既に成功している場合でも、awaitより後の処理は同じ呼び出しの途中では続きません。

Promiseを作るだけで、処理が別のCPUスレッドに移るわけではありません。この単元は通信もタイマーも使わず、JavaScriptの処理順だけを調べます。

const result = Promise.resolve(12);
console.log(result instanceof Promise);
console.log(await result);
結果を表すPromiseと、awaitで受け取った数値12は別の値です。
固定例の出力を確認
true
12

Promiseを作る関数と、結果を受け取る関数の順序

new Promiseへ渡す関数は、Promiseを作るときにすぐ実行されます。thenへ登録した処理は、その場で割り込まず、現在の同期処理の後に実行されます。

下の例ではresolveを2回呼んでも、採用される値は最初の1つです。thenが返したPromiseまでawaitして、表示が終わるのを待ちます。

console.log("開始");
const task = new Promise(resolve => {
  console.log("作成中");
  resolve("最初");
  resolve("二度目");
});
const displayed = task.then(value => console.log(value));
console.log("登録後");
await displayed;
作成用の関数は同期的に呼ばれ、thenの処理は「登録後」より後に実行されます。
固定例の出力を確認
開始
作成中
登録後
最初

async関数はPromiseを返し、awaitはその関数を中断する

asyncを付けた関数はPromiseを返します。関数内のreturnで成功値を決め、throwで失敗理由を決めます。単にasyncを付けても、重い同期計算が自動で軽くなることはありません。

awaitが待つのは、そのasync関数の続きです。呼び出し元や画面全体を止める命令ではありません。次の例は待機中に外側の処理が進む順序を示します。

このサイトのconsole欄はasync関数の中としてコードを実行するため、欄の先頭でもawaitを書けます。通常の関数へコピーした場合は、関数にasyncが必要です。モジュールのトップレベルawaitは別の構文条件です。

async function double(value) {
  return value * 2;
}
const task = double(6);
console.log(task instanceof Promise);
console.log(await task);
returnした12はPromiseの成功値になります。
固定例の出力を確認
true
12
async function show() {
  console.log("関数の開始");
  const value = await Promise.resolve("結果");
  console.log("関数の再開", value);
}
const task = show();
console.log("外側");
await task;
awaitでshowの続きが中断され、その間に外側のconsole.logが進みます。
固定例の出力を確認
関数の開始
外側
関数の再開 結果
function show() {
  const value = await Promise.resolve(12);
  console.log(value);
}
show();
通常の関数内にawaitを書くと構文エラーです。外側のconsole欄の包み方では、この内側の関数はasyncになりません。
固定例のエラー分類を確認
SyntaxError(詳細な文言は処理系によって異なります)

失敗したPromiseは、awaitする場所で捕まえる

async関数内のthrowは、返されたPromiseの失敗になります。try/catchの内側でawaitすると、その失敗をcatchへ渡せます。呼び出すだけでawaitしない場合は、このcatchでは後の拒否を受け取れません。

finallyは成功/失敗の後始末を書く場所です。ここでreturnやthrowをすると元の結果を置き換えるので、結果を変えたくない後始末では避けます。

catchで通常の値を返すと、その後のPromiseは成功として続きます。失敗を次へ伝える必要があれば、理由をthrowし直します。catchを書くだけで、自動的に再試行されるわけではありません。

async function load() {
  throw new Error("対象がありません");
}
try {
  console.log(await load());
} catch (error) {
  console.log("失敗", error.message);
} finally {
  console.log("後始末");
}
Promiseの拒否をawaitする位置で捕まえ、失敗時にもfinallyを通ります。エラーの文面はこの例が自分で定義した文字列です。
固定例の出力を確認
失敗 対象がありません
後始末
const value = await Promise.reject(new Error("未登録"))
  .catch(() => "代替値")
  .then(value => value + "を使う");
console.log(value);
catchが返した代替値を、次のthenが成功値として受け取ります。
固定例の出力を確認
代替値を使う

thenの中でreturnを忘れると、次へ値が渡らない

thenは新しいPromiseを返します。渡した関数が値をreturnすると、その値が次の処理へ渡ります。Promiseをreturnした場合は、その結果に従います。

関数を波括弧で囲んでreturnを省くと、次へ渡る値はundefinedです。計算をしたことと、結果を返したことを分けて確認します。

const missing = await Promise.resolve(3).then(value => {
  value * 2;
});
const returned = await Promise.resolve(3).then(value => {
  return Promise.resolve(value * 2);
});
console.log(missing);
console.log(returned);
最初は計算結果を捨てています。次はPromiseを返し、その成功値6まで待っています。
固定例の出力を確認
undefined
6

依存する処理は順に待ち、独立した処理はまとめて待つ

前の結果が次の入力になる場合は、順番にawaitします。互いの結果が不要な処理は、両方を開始してPromise.allでまとめて待てます。

Promise.allの結果の配列は、完了した順ではなく入力の順です。どれか1つが失敗すれば全体が失敗しますが、既に始まった残りの処理は自動では取り消されません。

下の例では、Promiseを成功させる関数を手元に置いて順序を固定します。実通信の速さや、並列処理の性能を測った例ではありません。

async function findUser() { return { id: 7 }; }
async function findLabel(id) { return "user-" + id; }
const user = await findUser();
console.log(await findLabel(user.id));
2つ目の関数に渡すIDは、1つ目の結果から取り出します。
固定例の出力を確認
user-7
let finishFirst;
const first = new Promise(resolve => { finishFirst = resolve; });
const second = Promise.resolve("B");
const both = Promise.all([first, second]);
finishFirst("A");
console.log((await both).join(","));
Bが先に成功していても、結果の並びは入力したfirst、secondの順です。
固定例の出力を確認
A,B
let finish;
const remaining = new Promise(resolve => { finish = resolve; })
  .then(value => { console.log(value); });
try {
  await Promise.all([Promise.reject(new Error("失敗")), remaining]);
} catch (error) {
  console.log(error.message);
}
finish("残りも動く");
await remaining;
全体の失敗を捕まえた後でも、残りのPromiseは進められます。処理の取消しは別の仕組みが必要です。
固定例の出力を確認
失敗
残りも動く

繰り返しの終了と、非同期処理の終了は別

forEachはcallbackが返すPromiseを待ちません。await forEachと書いても、全callbackの終了を待つ仕組みにはなりません。順番に行うならfor...ofの中でawaitし、独立した処理をまとめるならmapでPromiseの配列を作ります。

Promise.allを使うだけで同時実行数が制限されるわけではありません。大量の処理や実通信では個数制限・中断・失敗時の方針を別に設計します。ここでは固定の2件だけを扱います。

async function double(value) { return value * 2; }
const sequential = [];
for (const value of [1, 2]) {
  sequential.push(await double(value));
}
const together = await Promise.all([1, 2].map(double));
console.log(sequential.join(","));
console.log(together.join(","));
前半は1件ずつ待ち、後半は2件のPromiseを作ってまとめて待ちます。結果が同じでも、待つ位置が異なります。
固定例の出力を確認
2,4
2,4

自分で書いて確かめる

固定の商品情報を返すreadItem(id)を使い、showPrice(id)を実装してください。bookでは価格を、見つからないIDでは「商品がありません」を返します。通信は行いません。tryの中でawaitし、最後にbookとmissingの2つを試してください。

Ctrl / ⌘ + Enterで実行。Tabで欄の外へ移動。入力上限8,192文字、実行は約1.5秒、出力は60行 / 8KiBで停止します。

実行機能を準備しています。説明と固定例はそのまま読めます。

実際の出力

目標の出力
価格: 800
商品がありません
解答例と理由を見る(入力は変更しません)
async function readItem(id) {
  if (id !== "book") throw new Error("not_found");
  return { price: 800 };
}
async function showPrice(id) {
  try {
    const item = await readItem(id);
    return "価格: " + item.price;
  } catch {
    return "商品がありません";
  }
}
console.log(await showPrice("book"));
console.log(await showPrice("missing"));

awaitで成功値の商品情報を受け取り、拒否された場合はcatchで別の表示を返します。この固定関数の失敗はnot_foundだけです。実通信では通信失敗と未登録を同じ表示に決めつけず、次の単元で区別します。自由な答案の自動採点はまだ行いません。

到達確認:出力を予想する

A〜Dはどの順に表示されますか。async関数が最初のawaitへ到達するまでと、その後を分けて考えてください。

console.log("A");
async function work() {
  console.log("B");
  await Promise.resolve();
  console.log("C");
}
const task = work();
console.log("D");
await task;
出力を1つ選んでください

まだ回答を確認していません。

回答履歴は未確認です。

この画面での学習記録

  • 読了:未記録
  • 実行:未記録
  • 到達確認:未確認

読了・実行・この設問への正答は別の記録です。習熟やコース修了の認定ではありません。コード・単元の記録と到達確認の回答履歴は、ページ上部でそれぞれ明示保存・復元できます。過去の実行を現在の成功には扱いません。

つまずいたときに調べる

出典

固定例の検証環境:Node 24.22.3。ブラウザーでの表示・操作と同一の実測を意味しません。

コード・ノート・回答の保存と再開

コードと単元の記録から再開する

編集コード・読了の自己記録・過去に成功した入力と再開先を、明示操作でこの端末に保存できます。到達確認の回答履歴と、別タブの作品とは別の保存です。機密情報を含むコードや共用端末では保存を避けてください。過去の実行記録は現在の成功・習熟・修了の証明ではありません。

再開先:実行から始める

  1. 実行から始める 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  2. 変数・型・文字列 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  3. 比較・演算・変換 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  4. 条件分岐・反復 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  5. 関数 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  6. 配列・オブジェクト 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  7. 変換・絞り込み・集約 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  8. Promiseとasync/await 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

  9. モジュール・例外・デバッグ 未記録
    自分用ノート

    初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。

初期状態は画面内だけです。保存にはJavaScriptとIndexedDBが必要です。

全単元のコード・読了・実行履歴

旧教材版からコードを引き継ぐ

上の取込欄へ、このサイトから出した旧編集記録の控えを貼り、変更内容をプレビューしてください。別形式や到達確認の回答履歴は対象外です。教材版が異なる単元はコードだけを引き継ぎ、旧版の読了・実行記録は採用しません。

旧版の引継ぎは未実施です。

コードと各実行履歴は8,192文字・32KiB以内、全体1MiBまでです。保存・読込みはボタン操作時だけです。復元したコードは自動実行せず、出力・現在の判定・回答履歴も置き換えません。ブラウザーの削除や端末故障に備えて控えを残してください。

ノートの端末保存

上の各単元の「自分用ノート」を保存します。コード・読了・実行・回答の保存とは別です。ノートは実行も送信もしません。共用端末では保存を避け、ブラウザーの削除や端末故障に備えて控えを残してください。

ノートの再開先:実行から始める

初期は画面内だけです。端末保存にはJavaScriptとIndexedDBが必要です。

ノートだけを保存・復元する

保存・読込みはボタン操作時だけです。各ノートは8,192文字・32KiB、全体1MiBまで。教材版が違う保存は自動で移しません。控えは画面内の表示なので、手元のファイルへコピーしてください。

回答履歴から再開する

console対象単元の到達確認だけを記録します。この回答履歴にはコード・出力・読了・実行状況・選択肢そのものを含めません。コードと単元の記録は別の保存欄で扱います。回答履歴は復習用の自己記録で、習熟や修了の判定には使いません。

    端末内の到達確認履歴

    初期は画面内だけです。保存はこの端末・このブラウザーの同じサイト内だけで、送信・会員同期はしません。共用端末では保存を避けるか、使い終わったら保存回答を削除してください。問題の選択肢そのもの・コード・氏名は保存しません。

    保存操作にはJavaScriptとブラウザーのIndexedDBが必要です。本文と解答はそのまま読めます。

    回答状況の保存・復元・持出し

    控えや復元の記録は本人確認・初見・習熟・修了の証明ではありません。ブラウザーによる削除・容量不足・端末故障に備え、必要なら手元に控えを残してください。削除後の古い画面の再保存を拒む管理用の世代だけは残します。

    対応する画面間ではこのタブの入力を保持します。再読込み・タブ終了でRAMの入力は失われます。端末保存・復元・削除は明示操作で、過去の実行を今回の実行成功には扱いません。