async function 式

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年4月以降、すべてのブラウザーで利用可能です。

async function キーワードは、式の中で非同期関数を定義するために使用できます。

非同期関数は、async function 宣言またはアロー構文を使用して定義することもできます。

構文

js
async function (param0) {
  statements
}
async function (param0, param1) {
  statements
}
async function (param0, param1, /* …, */ paramN) {
  statements
}

async function name(param0) {
  statements
}
async function name(param0, param1) {
  statements
}
async function name(param0, param1, /* …, */ paramN) {
  statements
}

メモ: 式文は async function キーワードを使用することができません。async function 宣言との混同を防ぐためです。async function キーワードは文を受け付けることができないコンテキストで現れた場合のみ、式の始まりになります。

引数

name 省略可

関数名です。関数が無名の場合は省略可能です。名前は関数の本体内のみのローカルです。

paramN 省略可

関数に渡される引数名です。引数の構文については、関数リファレンスを参照してください。

statements 省略可

関数本体を構成する文です。

async function 式は async function 宣言とよく似ており、構文もほとんど同じです。async function 式と async function 宣言の主な違いは、async function 式が関数名を省略して無名関数を生成することができる点です。async function 式は、定義後直ちに実行される IIFE（即時実行関数式）として使用することもでき、最上位の await を模倣することができます。詳細は関数の章を見てください。

例

非同期関数式の使用

js
function resolveAfter2Seconds(x) {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(x);
    }, 2000);
  });
}

// 変数に代入された非同期関数式
const add = async function (x) {
  const a = await resolveAfter2Seconds(20);
  const b = await resolveAfter2Seconds(30);
  return x + a + b;
};

add(10).then((v) => {
  console.log(v); // 4 秒後に 60 を表示
});

// IIFE として使用される非同期関数式
(async function (x) {
  const p1 = resolveAfter2Seconds(20);
  const p2 = resolveAfter2Seconds(30);
  return x + (await p1) + (await p2);
})(10).then((v) => {
  console.log(v); // 2 秒後に 60 を表示
});

非同期 IIFE

async の IIFE を使用すると、 await および for...await を、最上位の await が利用できないコンテキストで使用することができます。ここでは、アロー関数を使用して IIFE を定義していますが、 async function 式も使用できます。

js
const getFileStream = async (url) => {
  // implementation
};

(async () => {
  const stream = await getFileStream("https://domain.name/path/file.ext");
  for await (const chunk of stream) {
    console.log({ chunk });
  }
})();