Асинхронные итераторы и for await
Асинхронные итераторы и for await...of: асинхронные генераторы, потоки событий и постраничная загрузка данных, плюс Array.fromAsync.
Когда значения приходят со временем
Обычный итератор отдаёт значения сразу. Но данные часто поступают порциями: страницы API, части файла, события. Для этого есть асинхронные итераторы: их метод next() возвращает промис, а перебирать их можно циклом for await...of (внутри async-функции или модуля).
Асинхронный генератор
Это функция async function*: в ней можно использовать и await, и yield.
const delay = (ms) => new Promise((r) => setTimeout(r, ms));
async function* countdown(n) {
while (n > 0) { await delay(10); yield n--; }
}
for await (const n of countdown(3)) console.log("осталось", n);
осталось 3
осталось 2
осталось 1
Цикл ждёт каждого значения и только потом выполняет тело. Как и в обычном цикле, можно выйти через break — генератор при этом корректно завершается:
for await (const n of countdown(5)) {
if (n === 3) break;
console.log("до break", n);
}
до break 5
до break 4
Постраничная загрузка
Типичная задача: API отдаёт данные страницами. Генератор прячет пагинацию от потребителя:
async function* pages() {
for (let p = 1; p <= 3; p++) {
await delay(10); // вместо fetch(".../items?page=" + p)
yield { page: p, items: [p * 10, p * 10 + 1] };
}
}
for await (const page of pages()) console.log(page);
{ page: 1, items: [ 10, 11 ] }
{ page: 2, items: [ 20, 21 ] }
{ page: 3, items: [ 30, 31 ] }
Страницы запрашиваются лениво: следующий запрос выполняется, только когда цикл попросил следующее значение.
Свой асинхронно итерируемый объект
Объект становится асинхронно итерируемым, если у него есть метод с ключом Symbol.asyncIterator (по аналогии с Symbol.iterator из уроков про итераторы). Удобно написать его как асинхронный генератор:
const ticker = {
async *[Symbol.asyncIterator]() { yield "a"; yield "b"; },
};
for await (const x of ticker) console.log(x); // a, затем b
for await принимает и обычные итерируемые: каждый элемент он «ожидает» через await:
for await (const v of [delay(20).then(() => "медленный"), "обычное"]) console.log(v);
медленный
обычное
Потоки событий и данных
Асинхронные итераторы естественно описывают потоки. Тело ответа fetch (res.body) и ReadableStream можно читать for await по частям (в современных браузерах и Node.js 18+). В Node.js модуль events умеет превращать события в такой поток:
const { EventEmitter, on } = require("node:events");
const ee = new EventEmitter();
const ac = new AbortController();
setTimeout(() => ee.emit("msg", "один"), 10);
setTimeout(() => ee.emit("msg", "два"), 20);
setTimeout(() => ac.abort(), 40);
try {
for await (const [text] of on(ee, "msg", { signal: ac.signal })) console.log("событие:", text);
} catch (e) { console.log("конец:", e.name); }
событие: один
событие: два
конец: AbortError
Здесь пригодился AbortController из прошлого урока: он останавливает бесконечный поток. Обратите внимание, что обработчик событий из DOM («клик») асинхронным итератором напрямую не является — для него в браузере такого стандартного метода нет.
Array.fromAsync
Метод Array.fromAsync собирает в массив все значения асинхронного итерируемого объекта (он доступен в Node.js 22 и новых браузерах; в старых окружениях его может не быть):
console.log(await Array.fromAsync(countdown(3))); // [ 3, 2, 1 ]
Напишите асинхронный генератор fakeFeed(count), который с задержкой 50 мс выдаёт объекты { id, text }. С помощью for await выведите первые четыре записи и остановитесь по break. Затем напишите генератор-обёртку take(iter, n), возвращающий только первые n значений.
Оглавление курса
Модуль 1Старт10
- 1Что такое JavaScript и где он работает
- 2Инструменты: редактор и консоль браузера
- 3Первый скрипт: script, console.log и Node.js
- 4Переменные: let, const и var
- 5Типы данных
- 6Числа и объект Math
- 7Строки и шаблонные литералы
- 8Комментарии, стиль кода и точка с запятой
- 9Браузер и Node.js: чем отличаются среды
- 10История языка и стандарт ECMAScript
Модуль 2Операторы и управление потоком10
Модуль 3Функции10
Модуль 4Объекты и массивы10
Модуль 5Строки, числа, даты и данные10
Модуль 6DOM и события10
Модуль 7Браузерные API10
Модуль 8Прототипы и классы10
Модуль 9Асинхронность10
Модуль 10Модули и инструменты10
Модуль 11Продвинутые возможности10
Модуль 12Ошибки, тесты и безопасность10
Модуль 13Node.js10
Модуль 14Экосистема и фреймворки10
- 131TypeScript: типы в повседневной работе
- 132React: обзор
- 133Vue и Svelte: обзор
- 134Управление состоянием: обзор
- 135Мета-фреймворки: Next.js, Nuxt, SvelteKit
- 136Современные инструменты сборки
- 137Сквозные тесты: Playwright
- 138Паттерны проектирования в JavaScript
- 139Архитектура больших приложений
- 140Безопасность зависимостей
Модуль 15Профи10
- 141Движок V8 и JIT-компиляция
- 142Память и сборка мусора
- 143Event Loop глубже: микрозадачи и макрозадачи
- 144Производительность и Web Vitals
- 145Вопросы на собеседовании по JavaScript
- 146Алгоритмы и структуры данных на JavaScript
- 147Код-ревью
- 148Вклад в open source
- 149Дипломный проект: разработка
- 150Дипломный проект: защита и итоги
