Constructeur Array()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Le constructeur Array() permet de créer des objets Array.

Syntaxe

js
[element0, element1, ..., elementN]

new Array(element0, element1[, ...[, elementN]])
new Array(longueurTableau)

Paramètres

elementN

Un tableau JavaScript est initialisé avec les éléments indiqués à moins qu'un seul argument ne soit passé (cf. longueurTableau ci-après). On notera que ce cas au limite ne s'applique qu'avec le constructeur Array. Si on utilise la forme littérale (avec les crochets), on peut initialiser un tableau avec un seul élément.

longueurTableau

Si le seul argument passé au constructeur Array est un entier entre 0 et 2^32-1 (inclus), le constructeur renverra un tableau dont la propriété length vaut ce nombre. Note : le tableau contiendra des éléments vides (à ne pas confondre avec des éléments qui vaudraient undefined). Si l'argument est un autre nombre, une exception RangeError sera levée.

Exemples

Utilisation de la notation littérale

Les tableaux peuvent être créés avec une notation littérale :

js
let fruits = ["Pomme", "Banane"];

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

Utilisation du constructeur avec un seul paramètre

On peut créer des tableaux grâce au constructeur avec un seul paramètre numérique. On crée alors un tableau dont la propriété length vaut le nombre passé en argument et dont les éléments sont vides.

js
let fruits = new Array(2);

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

Utilisation du constructeur avec plusieurs paramètres

Si on utilise plus d'un argument, un nouveau tableau (Array) sera construit avec les éléments passés en arguments.

js
let fruits = new Array("Pomme", "Banane");

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

Spécifications

Specification
ECMAScript Language Specification
# sec-array-constructor

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi