aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/javascript/reference/global_objects/array/length
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-08-03 08:03:23 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-09-03 08:08:25 +0200
commitbf8e099b9c8b3c60d60b3712b4fc97b052c39887 (patch)
treec101746d082c9581c94f5937519c7d0e2f4af8cb /files/fr/web/javascript/reference/global_objects/array/length
parent844f5103992238c0c23203286dad16a466e89c97 (diff)
downloadtranslated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.gz
translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.tar.bz2
translated-content-bf8e099b9c8b3c60d60b3712b4fc97b052c39887.zip
convert content to md
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/array/length')
-rw-r--r--files/fr/web/javascript/reference/global_objects/array/length/index.md119
1 files changed, 49 insertions, 70 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/array/length/index.md b/files/fr/web/javascript/reference/global_objects/array/length/index.md
index 4e05fe8940..caa912f99a 100644
--- a/files/fr/web/javascript/reference/global_objects/array/length/index.md
+++ b/files/fr/web/javascript/reference/global_objects/array/length/index.md
@@ -9,19 +9,18 @@ tags:
translation_of: Web/JavaScript/Reference/Global_Objects/Array/length
original_slug: Web/JavaScript/Reference/Objets_globaux/Array/length
---
-<div>{{JSRef}}</div>
+{{JSRef}}
-<p>La propriété <code><strong>length</strong></code> (longueur) est un entier non-signé de 32 bits qui indique le nombre d'éléments présents dans le tableau. Elle est toujours supérieure au plus grand indice du tableau.</p>
+La propriété **`length`** (longueur) est un entier non-signé de 32 bits qui indique le nombre d'éléments présents dans le tableau. Elle est toujours supérieure au plus grand indice du tableau.
-<div>{{EmbedInteractiveExample("pages/js/array-length.html")}}</div>
+{{EmbedInteractiveExample("pages/js/array-length.html")}}
+## Description
+La valeur de la propriété `length` est un entier de signe positif dont la valeur est inférieure à 2 à la puissance 32 (2^32).
-<h2 id="Description">Description</h2>
-
-<p>La valeur de la propriété <code>length</code> est un entier de signe positif dont la valeur est inférieure à 2 à la puissance 32 (2^32).</p>
-
-<pre class="brush: js notranslate">var tableauA = new Array(4294967296); // 2 à la puissance 32 = 4294967296
+```js
+var tableauA = new Array(4294967296); // 2 à la puissance 32 = 4294967296
var tableauC = new Array(-100) // une valeur négative
console.log(tableauA.length); // RangeError: Invalid array length
@@ -30,91 +29,71 @@ console.log(tableauC.length); // RangeError: Invalid array length
var tableauB = [];
tableauB.length = Math.pow(2,32)-1; // On déclare une longueur inférieure à 2 puissance 32
console.log(tableauB.length); // 4294967295
-</pre>
+```
-<p>Vous pouvez modifier la propriété <code>length</code> d'un tableau à loisir pour le tronquer. Quand vous étendez un tableau en modifiant la valeur de sa propriété <code>length</code>, le nombre d'éléments réellement présents dans ce tableau n'augmente pas : par exemple, si vous affectez la valeur 3 à la propriété <code>length</code> d'un tableau alors qu'elle vaut 2, le tableau contiendra toujours seulement 2 éléments. La troisième « case » ne sera pas itérable. De ce fait, la propriété <code>length</code> d'un tableau ne renseigne en rien sur le nombre de valeurs définies dans le tableau. Voir aussi <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array#Relation_entre_length_et_les_propri.C3.A9t.C3.A9s_num.C3.A9riques">la relation entre longueur et propriétés numériques</a>.</p>
+Vous pouvez modifier la propriété `length` d'un tableau à loisir pour le tronquer. Quand vous étendez un tableau en modifiant la valeur de sa propriété `length`, le nombre d'éléments réellement présents dans ce tableau n'augmente pas : par exemple, si vous affectez la valeur 3 à la propriété `length` d'un tableau alors qu'elle vaut 2, le tableau contiendra toujours seulement 2 éléments. La troisième « case » ne sera pas itérable. De ce fait, la propriété `length` d'un tableau ne renseigne en rien sur le nombre de valeurs définies dans le tableau. Voir aussi [la relation entre longueur et propriétés numériques](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array#Relation_entre_length_et_les_propri.C3.A9t.C3.A9s_num.C3.A9riques).
-<pre class="brush: js notranslate">const arr = [1, 2, 3];
+```js
+const arr = [1, 2, 3];
console.table(arr);
// [1, 2]
arr.length = 5; // On définit une longueur à 5
console.table(arr);
-// [1, 2, &lt;3 éléments vides&gt;]
+// [1, 2, <3 éléments vides>]
-arr.forEach(element =&gt; console.log(element));
+arr.forEach(element => console.log(element));
// 1
// 2
-</pre>
+```
-<p>{{js_property_attributes(1,0,0)}}</p>
+{{js_property_attributes(1,0,0)}}
-<h2 id="Exemples">Exemples</h2>
+## Exemples
-<h3 id="Renvoyer_la_longueur_dun_tableau">Renvoyer la longueur d'un tableau</h3>
+### Renvoyer la longueur d'un tableau
-<pre class="brush: js notranslate">var items = ["chaise", "bureau", "table", "sac"];
+```js
+var items = ["chaise", "bureau", "table", "sac"];
items.length; // 4
-</pre>
+```
-<h3 id="Parcourir_un_tableau">Parcourir un tableau</h3>
+### Parcourir un tableau
-<p>Dans l'exemple suivant, on itère sur le tableau <code>nombres</code> en utilisant la propriété <code>length</code> afin de connaître son nombre d'élément. La valeur de chaque élément est ensuite multipliée par deux :</p>
+Dans l'exemple suivant, on itère sur le tableau `nombres` en utilisant la propriété `length` afin de connaître son nombre d'élément. La valeur de chaque élément est ensuite multipliée par deux :
-<pre class="brush:js notranslate">var nombres = [1,2,3,4,5];
+```js
+var nombres = [1,2,3,4,5];
-for (var i = 0; i &lt; nombres.length; i++) {
+for (var i = 0; i < nombres.length; i++) {
nombres[i] *= 2;
}
// nombres vaut maintenant [2,4,6,8,10];
-</pre>
+```
-<h3 id="Tronquer_un_tableau">Tronquer un tableau</h3>
+### Tronquer un tableau
-<p>L'exemple suivant raccourcit le tableau <code>etatsUS</code> à 50 si sa longueur actuelle est supérieure à 50.</p>
+L'exemple suivant raccourcit le tableau `etatsUS` à 50 si sa longueur actuelle est supérieure à 50.
-<pre class="brush:js notranslate">if (etatsUS.length &gt; 50) {
+```js
+if (etatsUS.length > 50) {
etatsUS.length = 50;
-}</pre>
-
-<h2 id="Specifications">Specifications</h2>
-
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">État</th>
- <th scope="col">Commentaires</th>
- </tr>
- <tr>
- <td>{{SpecName('ES1')}}</td>
- <td>{{Spec2('ES1')}}</td>
- <td>Définition initiale.</td>
- </tr>
- <tr>
- <td>{{SpecName('ES5.1', '#sec-15.4.5.2', 'Array.length')}}</td>
- <td>{{Spec2('ES5.1')}}</td>
- <td></td>
- </tr>
- <tr>
- <td>{{SpecName('ES6', '#sec-properties-of-array-instances-length', 'Array.length')}}</td>
- <td>{{Spec2('ES6')}}</td>
- <td></td>
- </tr>
- <tr>
- <td>{{SpecName('ESDraft', '#sec-properties-of-array-instances-length', 'Array.length')}}</td>
- <td>{{Spec2('ESDraft')}}</td>
- <td></td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("javascript.builtins.Array.length")}}</p>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-
-<ul>
- <li>{{jsxref("Array")}}</li>
-</ul>
+}
+```
+
+## Specifications
+
+| Spécification | État | Commentaires |
+| ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- |
+| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. |
+| {{SpecName('ES5.1', '#sec-15.4.5.2', 'Array.length')}} | {{Spec2('ES5.1')}} | |
+| {{SpecName('ES6', '#sec-properties-of-array-instances-length', 'Array.length')}} | {{Spec2('ES6')}} | |
+| {{SpecName('ESDraft', '#sec-properties-of-array-instances-length', 'Array.length')}} | {{Spec2('ESDraft')}} | |
+
+## Compatibilité des navigateurs
+
+{{Compat("javascript.builtins.Array.length")}}
+
+## Voir aussi
+
+- {{jsxref("Array")}}