Array() コンストラクター
Array()
コンストラクターは Array
オブジェクトを生成するために使用します。
構文
[element0, element1, ..., elementN] new Array(element0, element1[, ...[, elementN]]) new Array(arrayLength)
引数
elementN
- JavaScript の配列は、与えられた要素で初期化されますが、
Array
コンストラクターに単一の引数が渡され、その引数が数値であった場合は例外です (下記の arrayLength 引数を参照してください)。なお、この特殊な場合は JavaScript の配列がArray
コンストラクターで生成されたときのみであり、ブラケット構文で配列リテラルを作成した場合は当てはまりません。 arrayLength
Array
コンストラクターに渡された唯一の引数が 0 から 232-1 の間 (両端を含む) の整数であった場合は、新しい JavaScript の配列を返し、そのlength
プロパティがその値になります (注: これはarrayLength
個の空のスロットを持つ配列であり、実際にundefined
の値が入ったスロットではありません)。この引数がそれ以外の数値であった場合は、RangeError
例外が発生します。
例
配列リテラル記法
配列はリテラル記法を使用して生成することができます。
let fruits = ['りんご', 'バナナ'];
console.log(fruits.length); // 2
console.log(fruits[0]); // "りんご"
単一の引数を持つ Array コンストラクター
配列は単一の数値の引数を持つコンストラクターで生成することができます。配列は length
プロパティにその値が設定されており、配列の要素は空スロットになります。
let fruits = new Array(2);
console.log(fruits.length); // 2
console.log(fruits[0]); // undefined
複数の引数を持つ Array コンストラクター
2つ以上の引数がコンストラクターに渡された場合、与えられた要素を持つ Array
が生成されます。
let fruits = new Array('りんご', 'バナナ');
console.log(fruits.length); // 2
console.log(fruits[0]); // "りんご"
仕様書
ブラウザーの互換性
BCD tables only load in the browser
関連情報
Array
クラス