Array() 构造函数

基线 广泛可用

此功能已完善，可在许多设备和浏览器版本上正常工作。它自 2015 年 7 月.

报告反馈

语法

Array() 构造函数创建 Array 对象。
new Array()
new Array(element1)
new Array(element1, element2)
new Array(element1, element2, /* …, */ elementN)
new Array(arrayLength)

Array()
Array(element1)
Array(element1, element2)
Array(element1, element2, /* …, */ elementN)
Array(arrayLength)

js

注意：Array() 可以带或不带 new 调用。两者都会创建一个新的 Array 实例。

参数

element1, …, elementN

JavaScript 数组将使用给定的元素进行初始化，但如果仅向 Array 构造函数传递一个参数，并且该参数是一个数字（请参阅下面的 arrayLength 参数），则除外。请注意，此特殊情况仅适用于使用 Array 构造函数创建的 JavaScript 数组，不适用于使用方括号语法创建的数组字面量。

arrayLength

如果仅向 Array 构造函数传递一个介于 0 到 232 - 1（含）之间的整数，则将返回一个新的 JavaScript 数组，其 length 属性设置为该数字（注意：这意味着一个包含 arrayLength 个空插槽的数组，而不是包含实际 undefined 值的插槽 - 请参阅 稀疏数组）。

异常

RangeError

示例

如果只有一个参数（arrayLength）是一个数字，但其值不是整数或不在 0 到 232 - 1（含）之间，则抛出此异常。

数组字面量表示法

Array() 构造函数创建 Array 对象。
const fruits = ["Apple", "Banana"];

console.log(fruits.length); // 2
console.log(fruits[0]); // "Apple"

可以使用 字面量 表示法创建数组

带单个参数的数组构造函数

Array() 构造函数创建 Array 对象。
const arrayEmpty = new Array(2);

console.log(arrayEmpty.length); // 2
console.log(arrayEmpty[0]); // undefined; actually, it is an empty slot
console.log(0 in arrayEmpty); // false
console.log(1 in arrayEmpty); // false
Array() 构造函数创建 Array 对象。
const arrayOfOne = new Array("2"); // Not the number 2 but the string "2"

console.log(arrayOfOne.length); // 1
console.log(arrayOfOne[0]); // "2"

可以使用带单个数字参数的构造函数创建数组。将创建一个数组，其 length 属性设置为该数字，并且数组元素为空插槽。

带多个参数的数组构造函数

Array() 构造函数创建 Array 对象。
const fruits = new Array("Apple", "Banana");

console.log(fruits.length); // 2
console.log(fruits[0]); // "Apple"

规范

如果向构造函数传递了多个参数，则将创建一个包含给定元素的新 Array。
规范
# ECMAScript 语言规范

浏览器兼容性

sec-array-constructor

另请参阅

  • 并在启用了 JavaScript 的情况下加载。启用 JavaScript 以查看数据。
  • 数组