dart:html

свойство iterator

Возвращает новый Iterator, позволяющий перебирать элементы этого Iterable.

Итерируемые классы могут задавать порядок перебора своих элементов (например, List всегда перебирается в порядке индексов) или оставлять его неопределённым (например, основанный на хешировании Set может перебираться в любом порядке).

При каждом чтении iterator возвращается новый итератор, который можно использовать для повторного перебора всех элементов. По итераторам одного и того же итерируемого объекта можно перемещаться независимо, однако они должны возвращать одни и те же элементы в одном и том же порядке, пока базовая коллекция не изменяется.

Изменение коллекции может привести к тому, что новые итераторы будут возвращать другие элементы, а порядок существующих элементов может измениться. Порядок перебора List задан точно, поэтому изменение списка предсказуемо меняет этот порядок. При добавлении нового элемента в основанный на хешировании Set порядок перебора может полностью измениться.

Изменение базовой коллекции после создания нового итератора может привести к ошибке при следующем вызове Iterator.moveNext для этого итератора. Любой изменяемый итерируемый класс должен указывать, какие операции нарушают перебор.

Реализация

Iterator<E> get iterator {
  // Note: NodeLists are not fixed size. And most probably length shouldn't
  // be cached in both iterator _and_ forEach method. For now caching it
  // for consistency.
  return new FixedSizeListIterator<E>(this);
}