非同期関数式

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

関連情報