Constructeur Array()

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 constructeur Array et que cet argument est un nombre (voir le paramètre arrayLength ci-dessous). On notera que ce cas particulier ne s'applique qu'aux tableaux créés avec le constructeur Array, et non aux littéraux de tableau créés avec la syntaxe des crochets.

arrayLength

Si le seul argument passé au constructeur Array 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 avec arrayLength d'emplacements vides, et non des emplacements contenant réellement la valeur undefined — voir tableaux 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 notation littérale :

const 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.

const tableauVide = new Array(2);

console.log(tableauVide.length); // 2
console.log(tableauVide[0]); // undefined ; en réalité, c'est un emplacement vide
console.log(0 in tableauVide); // false
console.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); // 1
console.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); // 2
console.log(fruits[0]); // "Pomme"

Spécifications

Compatibilité des navigateurs

Voir aussi

• Guide des collections indexées
• L'objet global Array