Constructeur Array()

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

Syntaxe

[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 232-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 :

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.

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.

let fruits = new Array('Pomme', 'Banane');

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

Spécifications

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi