База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Generator.prototype.next() — продължаване на генератор

Методът `next()` стартира или продължава изпълнението на синхронен генератор и връща обект с резултата от итерацията. Незадължителният му аргумент става резултатът от израза с обикновен `yield`, на който генераторът е спрял. Аргументът на първото извикване се игнорира.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

generator.next()
generator.next(value)

Generator.prototype.next е методът, който се използва като generator.next(). Извикването на функция function* създава генератор, но не изпълнява тялото му. Първото next() започва изпълнението, а следващите извиквания го продължават до следващото спиране или до приключване.

При обикновен yield предоставената стойност е в свойството value, а резултатът съдържа done: false. Когато генераторът приключи без изключение, резултатът съдържа done: true, а в value е стойността от return или undefined, ако не е зададена стойност. Следващите извиквания след приключване връщат { value: undefined, done: true }.

При делегиране чрез yield*, ако свойството done в резултата от next() на делегирания итератор се преобразува до булевата стойност false, next() на външния генератор връща същия обект без промени. Например, ако делегираният итератор върне {}, липсващото свойство done се приема за false, а върнатият обект все така няма нито value, нито done.

Когато генераторът е спрял на обикновен yield, аргументът на next(value) става резултатът от този израз. В const input = yield "ready" първата стъпка предоставя "ready", а следващото извикване next(7) присвоява 7 на input. Аргументът на първото извикване се игнорира, защото генераторът все още не е спрял на yield.

Повторното влизане чрез next() в генератор, който се изпълнява в момента, предизвиква TypeError. Всеки екземпляр преминава през последователността си само веднъж; извикай генераторната функция отново, за да започнеш отначало.

Примери

function* exchange() {
  const input = yield "ready";
  return input * 2;
}

const generator = exchange();

function print(result) {
  console.log(String(result.value) + " | " + result.done);
}

print(generator.next(999));
print(generator.next(7));
print(generator.next());

Резултат

ready | false
14 | true
undefined | true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници