JS: Iterator.prototype.drop

By Xah Lee. Date: .

(new in ECMAScript 2025)

iterator.drop(n)
  • Remove the first n yield of iterator.
  • Return a new Generator.

Normally you can use this method on any Iterable, because all standard iterable objects are also Iterator.

// define a generator function
function* gf() {
  for (let x of [1, 2, 3, 4, 5]) yield x;
}

console.log(
  JSON.stringify(Array.from(
    gf().drop(3),
  )) === `[4,5]`,
);
// true

// is iterable
console.log(Reflect.has(gf().drop(3), Symbol.iterator));
// true

// is iterator
console.log(Reflect.has(gf().drop(3), "next"));
// true