Project Configuration

Iterators and Generators

Iterables

An object is deemed iterable if it has an implementation for the Symbol.iterator property.
Some built-in types like Array, Map, Set, String, Int32Array, Uint32Array, etc. have their Symbol.iterator property already implemented.
Symbol.iterator function on an object is responsible for returning the list of values to iterate on.

for..of statements

for..of loops over an iterable object, invoking the Symbol.iterator property on the object.
Here is a simple for..of loop on an array:

for..of vs. for..in statements

Both for..of and for..in statements iterate over lists; the values iterated on are different though, for..in returns a list of keys on the object being iterated, whereas for..of returns a list of values of the numeric properties of the object being iterated.

Another distinction is that for..in operates on any object; it serves as a way to inspect properties on this object.
for..of on the other hand, is mainly interested in values of iterable objects. Built-in objects like Map and Set implement Symbol.iterator property allowing access to stored values.

Code generation

Targeting ES5 and ES3

When targeting an ES5 or ES3, iterators are only allowed on values of Array type.
It is an error to use for..of loops on non-Array values, even if these non-Array values implement the Symbol.iterator property.

The compiler will generate a simple for loop for a for..of loop, for instance: