できない.dev

async/await

別名: async 関数 / async function / await / async def / 非同期関数

Promise やコルーチンを同期処理のような見た目で書くための構文。
async を付けた関数は Promise(Python ではコルーチン)を返し、await はその結果が出るまで関数の実行を一時停止する。

公開:

定義

async/await は、非同期処理を上から順に読める形で書くための構文である。
JavaScript では async を付けた関数は必ず Promise を返し、関数内の await は Promise が確定するまでその関数の実行を止めて、解決値を式の値として受け取る。
Python の async def と await も同じ考え方で、こちらはコルーチンを扱う。

詳細

MDN(新しいタブで開く) によると、async 関数の中で捕まえなかった例外は、返した Promise の reject になる。
そのため await を try/catch で囲めば同期処理と同じ書き方でエラーを扱える。
await を使えるのは async 関数の中と、ES モジュールのトップレベルだけである。

async function load(url: string) {
  try {
    const res = await fetch(url);
    return await res.json();
  } catch (e) {
    console.error(e);
  }
}

よくある誤解

  • await を付け忘れた呼び出しは、Promise やコルーチンオブジェクトを返すだけである。
    Python では、呼んだだけのコルーチンは実行すらされない。
  • async にしただけでは並列に動かない。
    await を順に並べると 1 つずつ待つ。
    同時に待つなら Promise.all や asyncio.gather を使う。

関連

Python で await を忘れたときの警告は coroutine was never awaited で、テストで待ち切れないときは Jest の Exceeded timeout で扱っている。