dart:html

Свойство iterator

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

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

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

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

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

Исходный код

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