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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.