async function* 式

Baseline 広く利用可能

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

async function* キーワードは、式の内部で非同期ジェネレーター関数を定義するために使用できます。

また、 async function* 宣言を使って非同期ジェネレーター関数を定義することもできます。

試してみましょう

async function joinAll(generator) {
  let str = "";
  for await (const val of generator()) {
    str += val;
  }
  return str;
}
joinAll(async function* () {
  yield await Promise.resolve("a");
  yield await Promise.resolve("b");
  yield await Promise.resolve("c");
}).then((str) => console.log(str));
// 予想される結果: "abc"

構文

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 (Immediately Invoked Function Expression) として使うことができ、アドホックな非同期反復可能オブジェクトを作成することができます。詳しくは関数の章も参照してください。

例

async function* 式の使用

次の例では、無名の非同期ジェネレーター関数を定義し、それを x に代入しています。この関数は引数の2乗を返します。

js
const x = async function* (y) {
  yield Promise.resolve(y * y);
};
x(6)
  .next()
  .then((res) => console.log(res.value)); // 36

仕様書

ECMAScript® 2027 Language Specification
# sec-async-generator-function-definitions

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年8月30日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

async function* 式

目次

試してみましょう

構文

引数

解説

例

async function* 式の使用

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力