Iterator() constructor

Cú pháp

new Iterator()

Tham số

Không có.

Giá trị trả về

Một đối tượng Iterator mới.

Ngoại lệ

TypeError

Khi new.target chính là hàm Iterator, tức là khi hàm tạo Iterator tự khởi tạo.

Mô tả

Iterator đại diện cho một lớp trừu tượng — một lớp cung cấp các tiện ích chung cho các lớp con, nhưng không được thiết kế để khởi tạo trực tiếp. Nó là lớp cha của tất cả các lớp iterator khác và được sử dụng để tạo các lớp con triển khai các thuật toán lặp cụ thể — cụ thể là, tất cả các lớp con của Iterator phải triển khai phương thức next() theo yêu cầu của giao thức iterator. Vì Iterator thực sự không cung cấp phương thức next(), nên không có ý nghĩa khi khởi tạo Iterator trực tiếp.

Bạn cũng có thể sử dụng Iterator.from() để tạo một thực thể Iterator từ một đối tượng iterable hoặc iterator hiện có.

Ví dụ

Kế thừa Iterator

Ví dụ sau định nghĩa một cấu trúc dữ liệu tùy chỉnh, Range, cho phép lặp. Để làm cho một đối tượng có thể lặp, chúng ta có thể cung cấp phương thức [Symbol.iterator]() dưới dạng hàm generator:

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);
}

Điều này hoạt động, nhưng không đẹp như cách các iterator tích hợp hoạt động. Có hai vấn đề:

• Iterator được trả về kế thừa từ Generator, điều đó có nghĩa là các sửa đổi đối với Generator.prototype sẽ ảnh hưởng đến iterator được trả về, đây là sự rò rỉ trừu tượng.
• Iterator được trả về không kế thừa từ prototype tùy chỉnh, điều này khó hơn nếu chúng ta có ý định thêm các phương thức bổ sung cho iterator.

Chúng ta có thể mô phỏng cách triển khai của các iterator tích hợp, chẳng hạn như map iterators, bằng cách kế thừa từ Iterator. Điều này cho phép chúng ta định nghĩa các thuộc tính bổ sung, chẳng hạn như [Symbol.toStringTag], trong khi làm cho các phương thức iterator helper có sẵn trên iterator được trả về.

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,
      });

      // Tránh #RangeIterator bị truy cập từ bên ngoài
      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);
}

Mẫu kế thừa hữu ích nếu bạn muốn tạo nhiều iterator tùy chỉnh. Nếu bạn có một đối tượng iterable hoặc iterator hiện có không kế thừa từ Iterator, và bạn chỉ muốn gọi các phương thức iterator helper trên nó, bạn có thể sử dụng Iterator.from() để tạo một thực thể Iterator một lần.

Đặc điểm kỹ thuật

Tương thích trình duyệt

Xem thêm

• Polyfill của Iterator trong core-js
• es-shims polyfill của Iterator và các helper liên quan
• Iterator
• Iterator.from()