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

Spécification
ECMAScript (ECMA-262)
La définition de 'Array constructor' dans cette spécification.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
Array() constructorChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet 4Safari Support complet 1WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0nodejs Support complet 0.1.100

Légende

Support complet  
Support complet

Voir aussi