The `goog.dom.iter.ChildIterator` Class

`goog.dom.iter.ChildIterator(element, opt_reverse, opt_startIndex)`

Iterator over an Element's children.

element {Element}: The element to iterate over.
opt_reverse {boolean=}: Optionally traverse children from last to first.
opt_startIndex {number=}: Optional starting index.

Returns the {@code Iterator} object itself. This is used to implement the iterator protocol in JavaScript 1.7

opt_keys {boolean=}: Whether to return the keys or values. Default is to only return the values. This is being used by the for-in loop (true) and the for-each-in loop (false). Even though the param gives a hint about what the iterator will return there is no guarantee that it will return the keys when true is passed.
returns {!goog.iter.Iterator}: The object itself.

Returns the next value of the iteration. This will throw the object {@see goog.iter#StopIteration} when the iteration passes the end.