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

JavaScript / コードを試す

Promise — then / catch / finally と async / await

Promise は「あとで決まる値」を表します。3つの状態、then の繋がり方、途中で投げたときの流れ、 async 関数が必ず Promise を返すこと、同期処理より後回しになる順序までを実行して確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

Promise は、いまはまだ決まっていない値を表す入れ物です。 通信や読み込みのように、結果が出るまで待つものを扱います。

example.js

const value = Promise.resolve(1);

console.log(value instanceof Promise);
console.log(await value);
固定例の期待出力 · Node 24.22.3
true
1
表示用コードUTF-8 · LF

3つの状態

状態 意味 決まり方
pending まだ決まっていない 最初はこれ
fulfilled 値が決まった resolve(値)
rejected 失敗が決まった reject(理由) / 例外

一度決まったら変わりません。 決まったあとに resolve を呼んでも何も起きません。

繋げる

then() は新しい Promise を返すので、繋げられます。

example.js

const result = await Promise.resolve(1)
  .then((n) => n + 1)
  .then((n) => n * 10);

console.log(result);
固定例の期待出力 · Node 24.22.3
20
表示用コードUTF-8 · LF

then() の中で返した値が、次の then() に渡ります。 返さないと undefined が流れます。

example.js

console.log(await Promise.resolve(1).then(() => {}));
固定例の期待出力 · Node 24.22.3
undefined
表示用コードUTF-8 · LF

map() で return を忘れたときと同じ形の間違いです。 → Array.prototype.map()

失敗したとき

example.js

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);
固定例の期待出力 · Node 24.22.3
[ 'catch:だめ', 'finally' ]
表示用コードUTF-8 · LF

then は飛ばされます。 失敗したときは catch まで一気に進みます。 finally は成否に関係なく必ず通ります。

途中で例外を投げても同じです。

example.js

const out = await Promise.resolve(1)
  .then(() => {
    throw new Error('途中で失敗');
  })
  .then(() => 'ここは通らない')
  .catch((error) => 'catch: ' + error.message);

console.log(out);
固定例の期待出力 · Node 24.22.3
catch: 途中で失敗
表示用コードUTF-8 · LF

例外は、後ろの catch に向かって落ちていきます。 try / catch と同じ考え方です。

async 関数は必ず Promise を返す

example.js

const load = async () => 1;

console.log(load() instanceof Promise);
console.log(await load());
固定例の期待出力 · Node 24.22.3
true
1
表示用コードUTF-8 · LF

1 を返すと書いても、返るのは1 を包んだ Promiseです。 await を付けないと中身が取れません。

投げた場合も、例外がそのまま飛ぶのではなく拒否された Promiseになります。

example.js

const fail = async () => {
  throw new Error('投げた');
};

try {
  await fail();
} catch (error) {
  console.log('捕まえた:', error.message);
}
固定例の期待出力 · Node 24.22.3
捕まえた: 投げた
表示用コードUTF-8 · LF

await していない async 関数の中で投げると、誰も受け取らないまま残ります。 呼びっぱなしにしないでください。

同期処理より必ず後になる

example.js

const log = [];

log.push('1 同期');
Promise.resolve().then(() => log.push('3 マイクロタスク'));
log.push('2 同期');

await Promise.resolve();

console.log(log);
固定例の期待出力 · Node 24.22.3
[ '1 同期', '2 同期', '3 マイクロタスク' ]
表示用コードUTF-8 · LF

Promise.resolve() はすでに決まっているのに、then の中身は後から動きます。

決まった Promise の続きはマイクロタスクという待ち行列に積まれ、 いま動いているコードが最後まで終わってから実行されるからです。

「もう値はあるのだから、すぐ動くはず」は成り立ちません。

then と await の使い分け

同じことができます。読みやすいほうを選んでください。

example.js

const load = async (n) => n * 2;

console.log(await load(1).then((n) => n + 1));

const value = await load(1);
console.log(value + 1);
固定例の期待出力 · Node 24.22.3
3
3
表示用コードUTF-8 · LF
  • 順番に待つだけ … await のほうが読みやすい
  • 同時に走らせる … Promise.all() を使う
  • 繋いだ処理を関数として組み立てる … then が向く

→ 複数の非同期処理を同時に走らせる

よくある間違い

await を付け忘れる

javascript失敗・注意の例

const load = async () => 1;

const value = load();

console.log(value instanceof Promise);
console.log(value + 1);
固定例の期待出力 · Node 24.22.3
true
[object Promise]1
表示用コードUTF-8 · LF

エラーになりません。 Promise そのものが変数に入り、 文字列として繋がれて [object Promise] になります。

画面に [object Promise] が出たら、await の付け忘れを疑ってください。

catch を付けずに放置する

失敗した Promise を誰も受け取らないと、そのまま静かに残ります。 .catch() を書くか、try / catch の中で await してください。

new Promise で包み直す

javascript失敗・注意の例
const wrong = () => new Promise((resolve) => resolve(fetchSomething()));
表示用コードUTF-8 · LF

すでに Promise を返すものを、もう一度 new Promise で包む必要はありません。 async 関数の中で await するか、そのまま返してください。

new Promise を書くのは、Promise でない仕組み (古い形のコールバック、setTimeout など)を包むときだけです。

まとめ

  • Promise は「あとで決まる値」。状態は3つで、一度決まったら変わらない
  • then() は新しい Promise を返す。返さないと undefined が流れる
  • 失敗すると then を飛ばして catch へ。finally は必ず通る
  • async 関数は必ず Promise を返す。 投げても拒否された Promise になる
  • 決まっていても、続きはマイクロタスク。同期処理より必ず後
  • [object Promise] が出たら await の付け忘れ

出典

この教材の原文(Markdown・別タブ)