Arrays — reference

A reference is most useful once you have already needed it. If you have never written array.map, stop here and go build something. Come back when you find yourself reaching for a method and want the full menu.

¶The mental model

A JavaScript array is an ordered list. It is integer-indexed starting from 0. It can hold values of any type, in any combination. It is mutable. Its length is dynamic.

const xs = [1, 'two', { three: 3 }, [4]];
xs.length;   // 4
xs[0];       // 1
xs[3];       // [4]

¶Mutation

¶Iteration that returns a new array

These do not mutate the original. They return a new array.

xs.map(x => x * 2);      // [2, 4, 6]
xs.filter(x => x > 1);    // [2, 3]
xs.flatMap(x => [x, x]);  // [1, 1, 2, 2, 3, 3]
xs.slice(1);              // [2, 3]

¶Aggregations

xs.reduce((acc, x) => acc + x, 0); // sum
xs.some(x => x > 2);  // true
xs.every(x => x > 0); // true
xs.find(x => x > 1);  // 2
xs.includes(2);       // true