Что такое генератор в JavaScript — и почему функция со звёздочкой не запускается

Вот функция. Внутри первой строкой — console.log('старт'). Ты её вызываешь. В консоли — тишина.
function* loadPages() {
console.log('старт')
yield 'страница 1'
yield 'страница 2'
}
loadPages() // ничего не напечаталось
Это не баг. Из-за звёздочки после function это генератор. А генератор при вызове вообще не начинает работать. Он только выдаёт тебе пульт, которым можно запускать его по шагам. Разберём, зачем такое придумали и где ты с этим уже сталкиваешься.
Что такое генератор
Генератор — это функция, которая умеет вставать на паузу и продолжать с того же места.
Обычная функция работает как кофемашина: нажал кнопку — она делает всё до конца и отдаёт один результат. Генератор — как автомат с билетами: каждое нажатие выдаёт один билет, и автомат ждёт следующего нажатия.
Два признака в коде:
function*— звёздочка говорит: это генератор.yield— «отдай значение и замри здесь».
Как он работает по шагам
Вызов генератора возвращает объект-пульт. У пульта есть кнопка next():
const pages = loadPages() // создан пульт, код не запущен
pages.next() // печатает 'старт', отдаёт { value: 'страница 1', done: false }
pages.next() // { value: 'страница 2', done: false }
pages.next() // { value: undefined, done: true }
Мы проверили в Node 22: 'старт' появляется только на первом next(), не при вызове. Каждый next() прогоняет код до ближайшего yield и останавливается. done: true значит «билеты кончились».
Руками next() вызывают редко. Обычно генератор отдают в цикл for...of или в spread — они сами жмут кнопку, пока не придёт done:
for (const page of loadPages()) {
console.log(page)
}
[...loadPages()] // ['страница 1', 'страница 2']
Технически генератор — это итератор: объект, у которого есть next(). Поэтому for...of с ним и дружит.
Зачем это нужно
Бесконечные последовательности. Обычная функция не может вернуть бесконечный список — память кончится. Генератор может, потому что считает следующий элемент только по запросу:
function* makeIds() {
let id = 1
while (true) yield id++
}
const ids = makeIds()
ids.next().value // 1
ids.next().value // 2
while (true) без генератора повесил бы вкладку. Здесь он безопасен: каждый шаг ждёт твоего next().
Ленивая обработка больших данных. Не надо грузить миллион строк в память, чтобы показать первые десять. Генератор отдаст десять и остановится.
Постраничная загрузка. API отдаёт данные страницами по 50. Генератор прячет это внутри: снаружи ты видишь просто поток элементов.
Где ты уже встречал генераторы: стриминг ИИ
Вот самое частое место в 2026 году. Когда ИИ-ответ печатается по словам, SDK отдаёт тебе асинхронный итератор — родственника генератора, который ждёт сеть между шагами:
for await (const chunk of stream) {
process.stdout.write(chunk.text)
}
for await жмёт next(), ждёт следующий кусочек от сервера и сразу его выводит. Ты можешь написать такой источник и сам — через async function*. Как собрать это в живом интерфейсе, разобрано в статье про стриминг ответов ИИ.
Пример: все страницы API одним циклом
Вот как выглядит постраничная загрузка, спрятанная в генератор. API отдаёт по 50 записей и говорит, есть ли следующая страница:
async function* allOrders() {
let page = 1
while (true) {
const res = await fetch(`/api/orders?page=${page}`)
const data = await res.json()
yield* data.items
if (!data.hasMore) return
page++
}
}
for await (const order of allOrders()) {
if (order.total > 10000) console.log(order.id)
}
yield* отдаёт элементы массива по одному. Снаружи цикл не знает ни про страницы, ни про fetch — он просто получает заказы. А если поставить break после первого найденного, генератор не станет грузить остальные страницы.
Две ловушки, на которых спотыкаются все
Генератор одноразовый. Прошёл его до конца — второй раз он пуст:
const pages = loadPages();
console.log([...pages]) // ['страница 1', 'страница 2']
console.log([...pages]) // []
Мы проверили: второй spread вернул пустой массив, без ошибки. Если список «внезапно пропал» при повторном показе — вот причина. Нужен второй проход — вызови loadPages() заново или сохрани результат в массив.
return теряется в цикле. Значение из return генератор отдаёт с done: true. А for...of и spread на done: true останавливаются и это значение не берут:
function* g() { yield 1; yield 2; return 3 }
[...g()] // [1, 2] — тройки нет
Всё, что должно попасть в цикл, отдавай через yield, а не через return.
Чем генератор отличается от обычной функции?
Обычная функция выполняется целиком и возвращает одно значение. Генератор при вызове не выполняется вовсе, а потом отдаёт значения по одному и между ними стоит на паузе.
Нужно ли новичку писать генераторы самому?
Редко. Но читать их придётся: ИИ использует их для стриминга, пагинации и обхода больших данных. Увидел function* или for await — знаешь, что код работает по шагам.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





