Что такое…

Что такое генератор в 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →