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
[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 constructeurArray
. 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 vaudraientundefined
). Si l'argument est un autre nombre, une exceptionRangeError
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
Specification |
---|
ECMAScript Language Specification # sec-array-constructor |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- La classe
Array