非同期関数式

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

非同期関数は、 async function 文を使用して定義することもできます。

構文

async function [name]([param1[, param2[, ..., paramN]]]) {
  statements
}

ES2015 では、アロー関数を使用することもできます。

引数

name

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

paramN

関数に渡される引数名です。

statements

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

解説

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

シンプルな例

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

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

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

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

仕様書

Specification
ECMAScript Language Specification
# sec-async-function-definitions

ブラウザーの互換性

BCD tables only load in the browser

関連情報