PeekableArrayIterator

array~ PeekableArrayIterator

Create an iterator for an array that allows for peeking next values.

source = [0, 1, 2, 3, 4, 5];

// also quite helpful for document.querySelector(...)
itr = new utils.array.PeekableArrayIterator(source);

console.log(itr.next()); // { done: false, value: 0 }

//-- peek without moving the iterator
console.log(itr.peek.next()); // { done: false, value: 1 }
console.log(itr.peek.next()); // { done: false, value: 2 }
console.log(itr.peek.next()); // { done: false, value: 3 }
console.log(itr.peek.next()); // { done: false, value: 4 }
console.log(itr.peek.next()); // { done: true, value: 5 }

//-- move the main iterator
console.log(itr.next()); // { done: false, value: 1 }

Of course, for each will always work

for (let i of new utils.array.PeekableArrayIterator(source)) {
  console.log(i);
}
// 1\n2\n3\n4\n5