JavaScript / コードを試す
Promise — then / catch / finally と async / await
Promise は「あとで決まる値」を表します。3つの状態、then の繋がり方、途中で投げたときの流れ、 async 関数が必ず Promise を返すこと、同期処理より後回しになる順序までを実行して確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
Promise は、いまはまだ決まっていない値を表す入れ物です。
通信や読み込みのように、結果が出るまで待つものを扱います。
const value = Promise.resolve(1); console.log(value instanceof Promise); console.log(await value);
true 1
3つの状態
| 状態 | 意味 | 決まり方 |
|---|---|---|
| pending | まだ決まっていない | 最初はこれ |
| fulfilled | 値が決まった | resolve(値) |
| rejected | 失敗が決まった | reject(理由) / 例外 |
一度決まったら変わりません。 決まったあとに resolve を呼んでも何も起きません。
繋げる
then() は新しい Promise を返すので、繋げられます。
const result = await Promise.resolve(1) .then((n) => n + 1) .then((n) => n * 10); console.log(result);
20
then() の中で返した値が、次の then() に渡ります。
返さないと undefined が流れます。
console.log(await Promise.resolve(1).then(() => {}));
undefined
map() で return を忘れたときと同じ形の間違いです。
→ Array.prototype.map()
失敗したとき
const order = []; await Promise.reject(new Error('だめ')) .then(() => order.push('then')) .catch((error) => order.push('catch:' + error.message)) .finally(() => order.push('finally')); console.log(order);
[ 'catch:だめ', 'finally' ]
then は飛ばされます。 失敗したときは catch まで一気に進みます。
finally は成否に関係なく必ず通ります。
途中で例外を投げても同じです。
const out = await Promise.resolve(1) .then(() => { throw new Error('途中で失敗'); }) .then(() => 'ここは通らない') .catch((error) => 'catch: ' + error.message); console.log(out);
catch: 途中で失敗
例外は、後ろの catch に向かって落ちていきます。
try / catch と同じ考え方です。
async 関数は必ず Promise を返す
const load = async () => 1; console.log(load() instanceof Promise); console.log(await load());
true 1
1 を返すと書いても、返るのは1 を包んだ Promiseです。
await を付けないと中身が取れません。
投げた場合も、例外がそのまま飛ぶのではなく拒否された Promiseになります。
const fail = async () => { throw new Error('投げた'); }; try { await fail(); } catch (error) { console.log('捕まえた:', error.message); }
捕まえた: 投げた
await していない async 関数の中で投げると、誰も受け取らないまま残ります。
呼びっぱなしにしないでください。
同期処理より必ず後になる
const log = []; log.push('1 同期'); Promise.resolve().then(() => log.push('3 マイクロタスク')); log.push('2 同期'); await Promise.resolve(); console.log(log);
[ '1 同期', '2 同期', '3 マイクロタスク' ]
Promise.resolve() はすでに決まっているのに、then の中身は後から動きます。
決まった Promise の続きはマイクロタスクという待ち行列に積まれ、
いま動いているコードが最後まで終わってから実行されるからです。
「もう値はあるのだから、すぐ動くはず」は成り立ちません。
then と await の使い分け
同じことができます。読みやすいほうを選んでください。
const load = async (n) => n * 2; console.log(await load(1).then((n) => n + 1)); const value = await load(1); console.log(value + 1);
3 3
- 順番に待つだけ …
awaitのほうが読みやすい - 同時に走らせる …
Promise.all()を使う - 繋いだ処理を関数として組み立てる …
thenが向く
よくある間違い
await を付け忘れる
const load = async () => 1;
const value = load();
console.log(value instanceof Promise);
console.log(value + 1);true [object Promise]1
エラーになりません。 Promise そのものが変数に入り、
文字列として繋がれて [object Promise] になります。
画面に [object Promise] が出たら、await の付け忘れを疑ってください。
catch を付けずに放置する
失敗した Promise を誰も受け取らないと、そのまま静かに残ります。
.catch() を書くか、try / catch の中で await してください。
new Promise で包み直す
const wrong = () => new Promise((resolve) => resolve(fetchSomething()));すでに Promise を返すものを、もう一度 new Promise で包む必要はありません。
async 関数の中で await するか、そのまま返してください。
new Promise を書くのは、Promise でない仕組み
(古い形のコールバック、setTimeout など)を包むときだけです。
まとめ
Promiseは「あとで決まる値」。状態は3つで、一度決まったら変わらないthen()は新しいPromiseを返す。返さないとundefinedが流れる- 失敗すると
thenを飛ばしてcatchへ。finallyは必ず通る async関数は必ずPromiseを返す。 投げても拒否されたPromiseになる- 決まっていても、続きはマイクロタスク。同期処理より必ず後
[object Promise]が出たらawaitの付け忘れ