HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
View in English Always switch to English
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Le constructeur Array() permet de créer des objets Array.
Array()
Array
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)
Note : Array() peut être appelé avec ou sans new : les deux créent une nouvelle instance de Array.
new
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 232 — 1 (inclus), cela retourne un nouveau tableau JavaScript dont la propriété length vaut ce nombre.
length
Note : Cela implique un tableau avec arrayLength d'emplacements vides, et non des emplacements contenant réellement la valeur undefined — voir tableaux creux.
undefined
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 232 — 1 (inclus).
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"
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"
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"
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.