Generator

Das Generator Objekt wird von der Generator Function zurückgegeben und entspricht beidem, dem Iterable Protokoll und dem Iterator Protokoll.

Syntax

function* gen() { 
  yield 1;
  yield 2;
  yield 3;
}

var g = gen(); // "Generator { }"

Methoden

Generator.prototype.next()

Gibt einen Wert vom Generator zurück (ausgelöst durch yield).

Generator.prototype.return()

Gibt den gegebene Wert zurück und beendet den Generator.

Generator.prototype.throw()

Erzeugt einen Fehler im Generator (beendet auch den Generator, wenn der Fehler nicht im Generator abgefangen wird).

Beispiele

Ein unendlicher Iterator

function* idMaker() {
    var index = 0;
    while(true)
        yield index++;
}

var gen = idMaker(); // "Generator { }"

console.log(gen.next().value); // 0
console.log(gen.next().value); // 1
console.log(gen.next().value); // 2
// ...

Veraltete Generatorobjekte

Firefox (SpiderMonkey) hat eine frühe Version der Generatoren in JavaScript 1.7 implementiert, bei der kein Stern (*) in der Funktionsdeklaration nötig war (man benutzte nur das yield Schlüsselwort im Funktionsrumpf). Seit Firefox 58 (Released am 23. Januar 2018) sind diese veralteten Generatoren entfernt (Bug 1083482).

Veraltete Generator Methoden

Generator.prototype.next()

Gibt einen Wert vom yield Ausdruck zurück. Diese korrespondiert mit der next() Methode in ES2015 Generator Objekt.

Generator.prototype.close()

Beendet einen Generator, so dass der Aufruf von next() zu einem StopIteration Fehler führt. Diese korrespondiert mit der return() Methode in ES2015 Generator Objekt.

Generator.prototype.send()

Wird benutzt, um einen Wert zum Generator zu senden. Der wert wird vom yield Ausdruck zurückgegeben und gibt einen Wert vom nächsten yield Ausdruck zurück. Diese korrespondiert mit der next(x) Methode in ES2015 Generator Objekt.

Generator.prototype.throw()

Erzeugt einen Fehler im Generator. Diese korrespondiert mit der throw() Methode in ES2015 Generator Objekt.

Veraltete Generator Beispiele

function fibonacci() {
  var a = yield 1;
  yield a * 2;
}

var it = fibonacci();
console.log(it);          // "Generator {  }"
console.log(it.next());   // 1
console.log(it.send(10)); // 20
console.log(it.close());  // undefined
console.log(it.next());   // throws StopIteration (as the generator is now closed)

Spezifikationen

Browserkompatibilität

Siehe auch

Veraltete Generatoren

• Die veraltete Generator Function
• Der veraltete Generator Functionsausdruck
• StopIteration
• The legacy Iterator protocol

ES2015 Generatoren

• Functions
• function
• function Ausdruck
• Function
• function*
• function* Ausdruck
• GeneratorFunction
• The Iterator protocol