Iterator.from()

Cú pháp

Iterator.from(object)

Tham số

object

Một đối tượng triển khai giao thức iterable hoặc giao thức iterator.

Giá trị trả về

Nếu object là một iterable, phương thức [Symbol.iterator]() của nó được gọi để lấy iterator. Ngược lại, object được giả định là một iterator. Nếu iterator đã là instanceof Iterator (tức là có Iterator.prototype trong chuỗi prototype của nó), nó được trả về trực tiếp. Ngược lại, một đối tượng Iterator mới được tạo ra bọc iterator gốc.

Mô tả

Phương thức này tồn tại để chuyển đổi các iterator tùy chỉnh, có thể được xuất bởi các thư viện, thành các iterator chuẩn. Tất cả các đối tượng iterator do Iterator.from() trả về đều kế thừa từ một đối tượng prototype chung, có các phương thức sau:

next()

Gọi phương thức next() của iterator nền và trả về kết quả.

return()

Gọi phương thức return() của iterator nền và trả về kết quả, hoặc trả về { value: undefined, done: true } nếu iterator nền không có phương thức return().

Ví dụ

Chuyển đổi iterable thành iterator chuẩn

Vì obj đã là iterable trả về iterator chuẩn khi gọi phương thức [Symbol.iterator](), Iterator.from(obj) trả về iterator đó.

const iterator = (function* () {
  yield 1;
  yield 2;
  yield 3;
})();

const obj = {
  [Symbol.iterator]() {
    return iterator;
  },
};

const iterator2 = Iterator.from(obj);
console.log(iterator2 === iterator); // true

Vì obj2 là iterable trả về iterator không chuẩn khi gọi phương thức [Symbol.iterator](), Iterator.from(obj2) trả về iterator mới bọc iterator gốc.

const iterator = {
  current: 0,
  next() {
    return { value: this.current++, done: false };
  },
};

const obj2 = {
  [Symbol.iterator]() {
    return iterator;
  },
};

const iterator2 = Iterator.from(obj2);
console.log(iterator2 === iterator); // false
console.log(iterator2.next()); // { value: 0, done: false }
console.log(iterator.next()); // { value: 1, done: false }

Chuyển đổi iterator thành iterator chuẩn

Vì obj đã là iterator chuẩn, Iterator.from(obj) trả về chính nó.

const obj = (function* () {
  yield 1;
  yield 2;
  yield 3;
})();

const iterator = Iterator.from(obj);
console.log(iterator === obj); // true

Vì obj2 là iterator không chuẩn, Iterator.from(obj2) trả về iterator mới bọc iterator gốc.

const obj2 = {
  current: 0,
  next() {
    return { value: this.current++, done: false };
  },
};

const iterator = Iterator.from(obj2);
console.log(iterator === obj2); // false
console.log(iterator.next()); // { value: 0, done: false }
console.log(obj2.next()); // { value: 1, done: false }

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

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

Xem thêm

• Polyfill của Iterator.from trong core-js
• es-shims polyfill của Iterator.from
• Iterator
• Array.from()