Array.of()

The Array.of() method creates a new Array instance from a variable number of arguments, regardless of number or type of the arguments.

The difference between Array.of() and the Array constructor is in the handling of integer arguments: Array.of(7) creates an array with a single element, 7, whereas Array(7) creates an empty array with a length property of 7 (Note: this implies an array of 7 empty slots, not slots with actual undefined values).

Array.of(7); // [7]
Array(7); // array of 7 empty slots

Array.of(1, 2, 3); // [1, 2, 3]
Array(1, 2, 3);    // [1, 2, 3]

Syntax

Array.of(element0)
Array.of(element0, element1)
Array.of(element0, element1, ... , elementN)

Parameters

elementN

Elements used to create the array.

Return value

A new Array instance.

Description

This function is part of the ECMAScript 2015 standard.

For more information, see:

• Array.of()
• Array.from() proposal
• Array.of() polyfill

Examples

Using Array.of

Array.of(1);         // [1]
Array.of(1, 2, 3);   // [1, 2, 3]
Array.of(undefined); // [undefined]

Specifications

Browser compatibility

See also

• A polyfill of Array.of is available in core-js
• A polyfill
• Array
• Array.from()
• TypedArray.of()