This page was translated from English by the community.Learn more and join the MDN Web Docs community.
yield*
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2016 г..
**Выражениеyield* **используется для того, чтобы "передать управление" функцией-генератором другомугенератору или итерируемому объекту.
Синтаксис
yield* [[expression]];
expressionИтерируемый объект
Описание
Выражениеyield* в функции-генераторе принимает итерируемый объект и возвращает его значения по очереди, как если бы эта функция-генератор возвращала их сама.
Значение выраженияyield* само по себе равно последнему значению итерируемого объекта (т.е., того когдаdone равно true).
Примеры
Передача другому генератору
В следующем примере, значения полученные изg1() возвращаются изg2 вызовамиnext, как будто бы она вычислила их сама.
function* g1() { yield 2; yield 3; yield 4;}function* g2() { yield 1; yield* g1(); yield 5;}var iterator = g2();console.log(iterator.next()); // { value: 1, done: false }console.log(iterator.next()); // { value: 2, done: false }console.log(iterator.next()); // { value: 3, done: false }console.log(iterator.next()); // { value: 4, done: false }console.log(iterator.next()); // { value: 5, done: false }console.log(iterator.next()); // { value: undefined, done: true }Другие итерируемые объекты
Помимо объектов генераторов,yield* может перебирать другие виды итерируемых объектов, т.е. массивы, строки, объекты аргументов и др.
function* g3() { yield* [1, 2]; yield* "34"; yield* Array.from(arguments); // Определение этого итератора ниже yield* new PowesOfTwo(4);}var iterator = g3(5, 6);// Значения из массиваconsole.log(iterator.next()); // { value: 1, done: false }console.log(iterator.next()); // { value: 2, done: false }// Из строкиconsole.log(iterator.next()); // { value: "3", done: false }console.log(iterator.next()); // { value: "4", done: false }// Из аргументовconsole.log(iterator.next()); // { value: 5, done: false }console.log(iterator.next()); // { value: 6, done: false }// Из специального итератораconsole.log(iterator.next()); // { value: 1, done: false }console.log(iterator.next()); // { value: 2, done: false }console.log(iterator.next()); // { value: 4, done: false }console.log(iterator.next()); // { value: undefined, done: true }// Итератор, который возвращает все степени двойки// до maximum включительноclass PowersOfTwo { constructor(maximum) { this.maximum = maximum; this.value = 1; } [Symbol.iterator]() { const self = this; return { next() { if (self.value > self.maximum) return { done: true }; const value = self.value; self.value *= 2; return { done: false, value }; }, }; }}Собственное значение выраженияyield*
yield* - это выражение, а не оператор, поэтому оно имеет значение, равное последнему значению итератора
function* g4() { yield* [1, 2, 3]; return "foo";}var result;function* g5() { result = yield* g4();}var iterator = g5();console.log(iterator.next()); // { value: 1, done: false }console.log(iterator.next()); // { value: 2, done: false }console.log(iterator.next()); // { value: 3, done: false }console.log(iterator.next()); // { value: undefined, done: true },// g4() в этой точке вернёт { value: "foo", done: true }console.log(result); // "foo"Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-generator-function-definitions-runtime-semantics-evaluation |
Совместимость с браузерами
Специфичные для Firefox примечания
- Начиная с Gecko 33, разбор выражений yield было приведено к соответствию с последними спецификациями ES6 (Firefox bug 981599):
Реализована корректная обработка разрыва строки. Разрыва строки между "yield" и "*" быть не может. Такой код вызовет
SyntaxError:jsfunction* foo() { yield *[];}