{{JSRef}}
The Array.of()
method creates a new Array
instance with 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 array with 7 elements, each of which is undefined
.
Array.of(7); // [7] Array.of(1, 2, 3); // [1, 2, 3] Array(7); // [ , , , , , , ] Array(1, 2, 3); // [1, 2, 3]
Syntax
Array.of(element0[, element1[, ...[, elementN]]])
Parameters
elementN
- Elements of which to create the array.
Return value
A new {{jsxref("Array")}} instance.
Description
This function is part of the ECMAScript 6 standard. For more information see Array.of
and Array.from
proposal and Array.of
polyfill.
Examples
Array.of(1); // [1] Array.of(1, 2, 3); // [1, 2, 3] Array.of(undefined); // [undefined]
Polyfill
Running the following code before any other code will create Array.of()
if it's not natively available.
if (!Array.of) { Array.of = function() { return Array.prototype.slice.call(arguments); }; }
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('ES6', '#sec-array.of', 'Array.of')}} | {{Spec2('ES6')}} | Initial definition. |
{{SpecName('ESDraft', '#sec-array.of', 'Array.of')}} | {{Spec2('ESDraft')}} |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatChrome(45)}} | {{CompatGeckoDesktop("25")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | {{CompatNo}} | {{CompatChrome(39)}} | {{CompatGeckoMobile("25")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
See also
- {{jsxref("Array")}}
- {{jsxref("Array.from()")}}
- {{jsxref("TypedArray.of()")}}