1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
---
title: Constructeur Array()
slug: Web/JavaScript/Reference/Global_Objects/Array/Array
tags:
- Array
- Constructeur
- JavaScript
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Array/Array
original_slug: Web/JavaScript/Reference/Objets_globaux/Array/Array
---
<div>{{JSRef}}</div>
<p>Le constructeur <strong><code>Array()</code></strong> permet de créer des objets {{jsxref("Array")}}.</p>
<h2 id="Syntaxe">Syntaxe</h2>
<pre class="syntaxbox notranslate">[<var>element0</var>, <var>element1</var>, ..., <var>elementN</var>]
new Array(<var>element0</var>, <var>element1</var>[, ...[, <var>elementN</var>]])
new Array(<var>longueurTableau</var>)</pre>
<h3 id="Paramètres">Paramètres</h3>
<dl>
<dt><code>element<em>N</em></code></dt>
<dd>Un tableau JavaScript est initialisé avec les éléments indiqués à moins qu'un seul argument ne soit passé (cf. <code>longueurTableau</code> ci-après). On notera que ce cas au limite ne s'applique qu'avec le constructeur <code>Array</code>. Si on utilise la forme littérale (avec les crochets), on peut initialiser un tableau avec un seul élément.</dd>
<dt><code>longueurTableau</code></dt>
<dd>Si le seul argument passé au constructeur <code>Array</code> est un entier entre 0 et 2<sup>32</sup>-1 (inclus), le constructeur renverra un tableau dont la propriété <code>length</code> vaut ce nombre. <strong>Note :</strong> le tableau contiendra des éléments vides (à ne pas confondre avec des éléments qui vaudraient <code>undefined</code>). Si l'argument est un autre nombre, une exception {{jsxref("RangeError")}} sera levée.</dd>
</dl>
<h2 id="Exemples">Exemples</h2>
<h3 id="Utilisation_de_la_notation_littérale">Utilisation de la notation littérale</h3>
<p>Les tableaux peuvent être créés avec une notation <a href="/fr/docs/Web/JavaScript/Reference/Grammaire_lexicale#Litt%C3%A9raux_de_tableaux">littérale</a> :</p>
<pre class="brush: js notranslate">let fruits = ['Pomme', 'Banane'];
console.log(fruits.length); // 2
console.log(fruits[0]); // "Pomme"
</pre>
<h3 id="Utilisation_du_constructeur_avec_un_seul_paramètre">Utilisation du constructeur avec un seul paramètre</h3>
<p>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é <code>length</code> vaut le nombre passé en argument et dont les éléments sont vides.</p>
<pre class="brush: js notranslate">let fruits = new Array(2);
console.log(fruits.length); // 2
console.log(fruits[0]); // undefined
</pre>
<h3 id="Utilisation_du_constructeur_avec_plusieurs_paramètres">Utilisation du constructeur avec plusieurs paramètres</h3>
<p>Si on utilise plus d'un argument, un nouveau tableau ({{jsxref("Array")}}) sera construit avec les éléments passés en arguments.</p>
<pre class="brush: js notranslate">let fruits = new Array('Pomme', 'Banane');
console.log(fruits.length); // 2
console.log(fruits[0]); // "Pomme"
</pre>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-array-constructor', 'Array constructor')}}</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div>
<p>{{Compat("javascript.builtins.Array.Array")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li>La classe {{jsxref("Array")}}</li>
</ul>
|
