Array() コンストラクター

Array() コンストラクターは Array オブジェクトを生成するために使用します。

構文

new Array(element0, element1, /* … ,*/ elementN)
new Array(arrayLength)

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

メモ: Array()new を付けてもつけなくても呼び出せます。どちらも新しい Array のインスタンスを生成します。

引数

elementN

JavaScript の配列は、与えられた要素で初期化されますが、 Array コンストラクターに単一の引数が渡され、その引数が数値であった場合は例外です (下記の arrayLength 引数を参照してください)。なお、この特殊な場合は JavaScript の配列が Array コンストラクターで生成されたときのみであり、ブラケット構文で配列リテラルを作成した場合は当てはまりません。

arrayLength

Array コンストラクターに渡された唯一の引数が 0 から 232-1 の間(両端を含む)の整数であった場合は、新しい JavaScript の配列を返し、その length プロパティがその値になります(注: これは arrayLength 個の空のスロットを持つ配列であり、実際に undefined の値が入ったスロットではありません。疎配列を参照してください)。

例外

RangeError

引数が 1 つ (arrayLength) だけであり、その値が 0 and 232 - 1 (両端を含む)の範囲内にな勝った場合に発生します。

配列リテラル記法

配列はリテラル記法を使用して生成することができます。

const fruits = ['りんご', 'バナナ'];

console.log(fruits.length); // 2
console.log(fruits[0]);     // "りんご"

単一の引数を持つ Array コンストラクター

配列は単一の数値の引数を持つコンストラクターで生成することができます。配列は length プロパティにその値が設定されており、配列の要素は空スロットになります。

const fruits = new Array(2);

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

複数の引数を持つ Array コンストラクター

2 つ以上の引数がコンストラクターに渡された場合、与えられた要素を持つ新しい Array が生成されます。

const fruits = new Array('りんご', 'バナナ');

console.log(fruits.length); // 2
console.log(fruits[0]);     // "りんご"

仕様書

Specification
ECMAScript Language Specification
# sec-array-constructor

ブラウザーの互換性

BCD tables only load in the browser

関連情報