コードを書き、予想と実際の出力を比べて学ぶ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);固定例の出力を確認
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;固定例の出力を確認
開始 作成中 登録後 最初
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);固定例の出力を確認
true 12
async function show() {
console.log("関数の開始");
const value = await Promise.resolve("結果");
console.log("関数の再開", value);
}
const task = show();
console.log("外側");
await task;固定例の出力を確認
関数の開始 外側 関数の再開 結果
function show() {
const value = await Promise.resolve(12);
console.log(value);
}
show();固定例のエラー分類を確認
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("後始末");
}固定例の出力を確認
失敗 対象がありません 後始末
const value = await Promise.reject(new Error("未登録"))
.catch(() => "代替値")
.then(value => value + "を使う");
console.log(value);固定例の出力を確認
代替値を使う
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);固定例の出力を確認
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));固定例の出力を確認
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(","));固定例の出力を確認
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;固定例の出力を確認
失敗 残りも動く
繰り返しの終了と、非同期処理の終了は別
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(","));固定例の出力を確認
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;まだ回答を確認していません。
回答履歴は未確認です。
この画面での学習記録
- 読了:未記録
- 実行:未記録
- 到達確認:未確認
読了・実行・この設問への正答は別の記録です。習熟やコース修了の認定ではありません。コード・単元の記録と到達確認の回答履歴は、ページ上部でそれぞれ明示保存・復元できます。過去の実行を現在の成功には扱いません。
つまずいたときに調べる
- SyntaxError: await is only valid in async functions
通常の関数内にawaitを書いたときの構文エラーを調べる。
- Promise — then / catch / finally と async / await
async/awaitとtry/catchの書き方を辞典で確認する。
出典
- ECMAScript作業版:Promise Objects(別タブ)
- ECMAScript作業版:Promise.prototype.then(別タブ)
- ECMAScript作業版:Await(別タブ)
- ECMAScript作業版:Async Function Definitions(別タブ)
- ECMAScript作業版:Array.prototype.forEach(別タブ)
固定例の検証環境:Node 24.22.3。ブラウザーでの表示・操作と同一の実測を意味しません。
コード・ノート・回答の保存と再開
コードと単元の記録から再開する
編集コード・読了の自己記録・過去に成功した入力と再開先を、明示操作でこの端末に保存できます。到達確認の回答履歴と、別タブの作品とは別の保存です。機密情報を含むコードや共用端末では保存を避けてください。過去の実行記録は現在の成功・習熟・修了の証明ではありません。
再開先:実行から始める
- 実行から始める 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 変数・型・文字列 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 比較・演算・変換 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 条件分岐・反復 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 関数 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 配列・オブジェクト 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- 変換・絞り込み・集約 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- Promiseとasync/await 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
- モジュール・例外・デバッグ 未記録
自分用ノート
初期は画面内だけです。コード・回答とは別に、下の「ノートの端末保存」で明示保存できます。秘密情報や個人情報は書かないでください。
初期状態は画面内だけです。保存にはJavaScriptとIndexedDBが必要です。
コードと各実行履歴は8,192文字・32KiB以内、全体1MiBまでです。保存・読込みはボタン操作時だけです。復元したコードは自動実行せず、出力・現在の判定・回答履歴も置き換えません。ブラウザーの削除や端末故障に備えて控えを残してください。
ノートの端末保存
上の各単元の「自分用ノート」を保存します。コード・読了・実行・回答の保存とは別です。ノートは実行も送信もしません。共用端末では保存を避け、ブラウザーの削除や端末故障に備えて控えを残してください。
ノートの再開先:実行から始める
初期は画面内だけです。端末保存にはJavaScriptとIndexedDBが必要です。
保存・読込みはボタン操作時だけです。各ノートは8,192文字・32KiB、全体1MiBまで。教材版が違う保存は自動で移しません。控えは画面内の表示なので、手元のファイルへコピーしてください。
回答履歴から再開する
console対象単元の到達確認だけを記録します。この回答履歴にはコード・出力・読了・実行状況・選択肢そのものを含めません。コードと単元の記録は別の保存欄で扱います。回答履歴は復習用の自己記録で、習熟や修了の判定には使いません。
端末内の到達確認履歴
初期は画面内だけです。保存はこの端末・このブラウザーの同じサイト内だけで、送信・会員同期はしません。共用端末では保存を避けるか、使い終わったら保存回答を削除してください。問題の選択肢そのもの・コード・氏名は保存しません。
保存操作にはJavaScriptとブラウザーのIndexedDBが必要です。本文と解答はそのまま読めます。
控えや復元の記録は本人確認・初見・習熟・修了の証明ではありません。ブラウザーによる削除・容量不足・端末故障に備え、必要なら手元に控えを残してください。削除後の古い画面の再保存を拒む管理用の世代だけは残します。
対応する画面間ではこのタブの入力を保持します。再読込み・タブ終了でRAMの入力は失われます。端末保存・復元・削除は明示操作で、過去の実行を今回の実行成功には扱いません。