Iterator() Konstruktor

new Iterator()

Note: Iterator() kann nur mit new konstruiert werden. Der Versuch, ihn ohne new zu aufzurufen, führt zu einem TypeError. Außerdem kann Iterator() nicht direkt konstruiert werden – es wird normalerweise implizit durch super()-Aufrufe innerhalb des Konstruktors einer Unterklasse konstruiert.

Keine.

Ein neues Iterator-Objekt.

TypeError

Wenn new.target die Iterator-Funktion selbst ist, d.h. wenn der Iterator-Konstruktor selbst konstruiert wird.

Iterator repräsentiert eine abstrakte Klasse — eine Klasse, die gemeinsame Utilities für ihre Unterklassen bereitstellt, aber nicht selbst instanziiert werden soll. Es ist die Oberklasse aller anderen Iterator-Klassen und wird verwendet, um Unterklassen zu erstellen, die spezifische Iterationsalgorithmen implementieren — insbesondere müssen alle Unterklassen von Iterator eine next()-Methode implementieren, wie es vom Iterator-Protokoll gefordert wird. Da Iterator die next()-Methode nicht tatsächlich bereitstellt, macht es keinen Sinn, einen Iterator direkt zu konstruieren.

Sie können auch Iterator.from() verwenden, um eine Iterator-Instanz aus einem vorhandenen iterierbaren oder Iterator-Objekt zu erstellen.

Das folgende Beispiel definiert eine benutzerdefinierte Datenstruktur, Range, die die Iteration erlaubt. Der einfachste Weg, ein Objekt iterierbar zu machen, besteht darin, eine [Symbol.iterator]()-Methode in Form einer Generatorfunktion bereitzustellen:

class Range {
  #start;
  #end;
  #step;

  constructor(start, end, step = 1) {
    this.#start = start;
    this.#end = end;
    this.#step = step;
  }

  *[Symbol.iterator]() {
    for (let value = this.#start; value <= this.#end; value += this.#step) {
      yield value;
    }
  }
}

const range = new Range(1, 5);
for (const num of range) {
  console.log(num);
}

Dies funktioniert, ist aber nicht so elegant wie die Funktionsweise eingebauter Iteratoren. Es gibt zwei Probleme:

• Der zurückgegebene Iterator erbt von Generator, was bedeutet, dass Änderungen an Generator.prototype den zurückgegebenen Iterator beeinflussen, was ein Verlust der Abstraktion darstellt.
• Der zurückgegebene Iterator erbt nicht von einem benutzerdefinierten Prototypen, was es schwieriger macht, wenn wir beabsichtigen, dem Iterator zusätzliche Methoden hinzuzufügen.

Wir können die Implementierung von eingebauten Iteratoren nachahmen, wie z.B. Karten-Iteratoren, indem wir Iterator vererben. Dies ermöglicht uns, zusätzliche Eigenschaften, wie [Symbol.toStringTag], zu definieren, während die Iterator-Hilfsmethoden auf dem zurückgegebenen Iterator verfügbar sind.

class Range {
  #start;
  #end;
  #step;

  constructor(start, end, step = 1) {
    this.#start = start;
    this.#end = end;
    this.#step = step;
  }

  static #RangeIterator = class extends Iterator {
    #cur;
    #s;
    #e;
    constructor(range) {
      super();
      this.#cur = range.#start;
      this.#s = range.#step;
      this.#e = range.#end;
    }
    static {
      Object.defineProperty(this.prototype, Symbol.toStringTag, {
        value: "Range Iterator",
        configurable: true,
        enumerable: false,
        writable: false,
      });

      // Avoid #RangeIterator from being accessible outside
      delete this.prototype.constructor;
    }
    next() {
      if (this.#cur > this.#e) {
        return { value: undefined, done: true };
      }
      const res = { value: this.#cur, done: false };
      this.#cur += this.#s;
      return res;
    }
  };

  [Symbol.iterator]() {
    return new Range.#RangeIterator(this);
  }
}

const range = new Range(1, 5);
for (const num of range) {
  console.log(num);
}

Das Muster der Vererbung ist nützlich, wenn Sie viele benutzerdefinierte Iteratoren erstellen möchten. Wenn Sie ein vorhandenes iterierbares oder Iterator-Objekt haben, das nicht von Iterator erbt und Sie nur die Iterator-Hilfsmethoden aufrufen möchten, können Sie Iterator.from() verwenden, um eine einmalige Iterator-Instanz zu erstellen.

• Polyfill von Iterator in core-js
• Iterator
• Iterator.from()