Le constructeurArray() permet de créer des objetsArray.

Syntaxe

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)

Paramètres

element1, …,elementN

Un tableau JavaScript est initialisé avec les éléments indiqués, sauf dans le cas où un seul argument est passé au constructeurArray et que cet argument est un nombre (voir le paramètrearrayLength ci-dessous). On notera que ce cas particulier ne s'applique qu'aux tableaux créés avec le constructeurArray, et non aux littéraux de tableau créés avec la syntaxe des crochets.

arrayLength

Si le seul argument passé au constructeurArray est un entier entre 0 et 2³² — 1 (inclus), cela retourne un nouveau tableau JavaScript dont la propriétélength vaut ce nombre.

Note :Cela implique un tableau avecarrayLength d'emplacements vides, et non des emplacements contenant réellement la valeurundefined — voirtableaux creux.

Exceptions

RangeError

Levée s'il n'y a qu'un seul argument (arrayLength) qui est un nombre, mais que sa valeur n'est pas un entier ou n'est pas comprise entre 0 et 2³² — 1 (inclus).

Exemples

Utilisation de la notation littérale

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

const fruits = ["Pomme", "Banane"];console.log(fruits.length); // 2console.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.

const tableauVide = new Array(2);console.log(tableauVide.length); // 2console.log(tableauVide[0]); // undefined ; en réalité, c'est un emplacement videconsole.log(0 in tableauVide); // falseconsole.log(1 in tableauVide); // false

const tableauDeUn = new Array("2"); // Ce n'est pas le nombre 2 mais la chaîne de caractères « 2 »console.log(tableauDeUn.length); // 1console.log(tableauDeUn[0]); // "2"

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.

const fruits = new Array("Pomme", "Banane");console.log(fruits.length); // 2console.log(fruits[0]); // "Pomme"

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet globalArray