AsyncIterator.prototype[Symbol.asyncIterator]()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

[Symbol.asyncIterator]() 方法是 AsyncIterator 例項的成員,它實現了 非同步可迭代協議,並允許內建非同步迭代器被期望非同步可迭代物件的語法(例如 for await...of 迴圈)所使用。它返回 this 的值,即非同步迭代器物件本身。

語法

js
asyncIterator[Symbol.asyncIterator]()

引數

無。

返回值

this 的值,即非同步迭代器物件本身。

示例

使用 for await...of 迴圈進行迭代

請注意,您很少需要直接呼叫此方法。[Symbol.asyncIterator]() 方法的存在使得所有內建非同步迭代器都成為 非同步可迭代物件,並且像 for await...of 迴圈這樣的迭代語法會自動呼叫此方法來獲取要遍歷的非同步迭代器。

js
const asyncIterator = (async function* () {
  yield 1;
  yield 2;
  yield 3;
})();
(async () => {
  for await (const value of asyncIterator) {
    console.log(value);
  }
})();
// Logs: 1, 2, 3

規範

規範
ECMAScript® 2026 語言規範
# sec-asynciteratorprototype-asynciterator

瀏覽器相容性

另見