diff options
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/array')
34 files changed, 96 insertions, 164 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/array/array/index.html b/files/fr/web/javascript/reference/global_objects/array/array/index.html index 9658d81205..5efe9b60c6 100644 --- a/files/fr/web/javascript/reference/global_objects/array/array/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/array/index.html @@ -26,7 +26,7 @@ new Array(<var>longueurTableau</var>)</pre> <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> + <dd>Si le seul argument passé au constructeur <code>Array</code> est un entier entre 0 et 2^32-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> diff --git a/files/fr/web/javascript/reference/global_objects/array/concat/index.html b/files/fr/web/javascript/reference/global_objects/array/concat/index.html index 153fac6ba3..e39788b6a0 100644 --- a/files/fr/web/javascript/reference/global_objects/array/concat/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/concat/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/concat <div>{{EmbedInteractiveExample("pages/js/array-concat.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox">let <var>nouveau_tableau</var> = <var>ancien_tableau</var>.concat(<var>valeur1</var>[, <var>valeur2</var>[, ...[, <var>valeurN</var>]]])</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/copywithin/index.html b/files/fr/web/javascript/reference/global_objects/array/copywithin/index.html index 72a8ed1cae..befc06152e 100644 --- a/files/fr/web/javascript/reference/global_objects/array/copywithin/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/copywithin/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/copyWithin <div>{{EmbedInteractiveExample("pages/js/array-copywithin.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox">arr.copyWithin(cible) @@ -37,11 +35,9 @@ arr.copyWithin(cible, début, fin) <p>Si <code>cible </code>est supérieur ou égal à <code>arr.length</code>, rien ne sera copié. Si <code>cible</code> est positionné apès <code>début</code>, la séquence copiée sera réduite pour correspondre à <code>arr.length</code>.</p> </dd> <dt><code>début</code> {{optional_inline}}</dt> - <dd>Indice de début de la séquence a copier. Si la valeur est négative, <code>début</code> sera compté à partir de la fin du tableau.</dd> - <dd>Si <code>début</code> est omis, <code>copyWithin</code> copiera à partir du début du tableau (par défaut 0).</dd> + <dd>Indice de début de la séquence a copier. Si la valeur est négative, <code>début</code> sera compté à partir de la fin du tableau. Si <code>début</code> est omis, <code>copyWithin</code> copiera à partir du début du tableau (par défaut 0).</dd> <dt><code>fin</code> {{optional_inline}}</dt> - <dd>Indice de fin de la séquence a copier. <code>copyWithin</code> copie jusqu'à <code>fin</code> (non-inclusif). Si la valeur est négative, <code>end</code> sera compté à partir de la fin du tableau.</dd> - <dd>Si <code>end</code> est omis, <code>copyWithin</code> copiera jusqu'à la fin du tableau (par défaut <code>arr.length</code>).</dd> + <dd>Indice de fin de la séquence a copier. <code>copyWithin</code> copie jusqu'à <code>fin</code> (non-inclusif). Si la valeur est négative, <code>end</code> sera compté à partir de la fin du tableau. Si <code>end</code> est omis, <code>copyWithin</code> copiera jusqu'à la fin du tableau (par défaut <code>arr.length</code>).</dd> </dl> <h3 id="Valeur_de_retour">Valeur de retour</h3> diff --git a/files/fr/web/javascript/reference/global_objects/array/entries/index.html b/files/fr/web/javascript/reference/global_objects/array/entries/index.html index 089f3b8429..5ab8acec51 100644 --- a/files/fr/web/javascript/reference/global_objects/array/entries/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/entries/index.html @@ -17,8 +17,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/entries <div>{{EmbedInteractiveExample("pages/js/array-entries.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.entries()</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/every/index.html b/files/fr/web/javascript/reference/global_objects/array/every/index.html index 5f186fb883..65dfaf3c44 100644 --- a/files/fr/web/javascript/reference/global_objects/array/every/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/every/index.html @@ -22,8 +22,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/every <div>{{EmbedInteractiveExample("pages/js/array-every.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.every(<var>callback</var>[, <var>thisArg</var>])</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/fill/index.html b/files/fr/web/javascript/reference/global_objects/array/fill/index.html index 2028140f87..dc4d155415 100644 --- a/files/fr/web/javascript/reference/global_objects/array/fill/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/fill/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/fill <div>{{EmbedInteractiveExample("pages/js/array-fill.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.fill(valeur<var><var>) diff --git a/files/fr/web/javascript/reference/global_objects/array/filter/index.html b/files/fr/web/javascript/reference/global_objects/array/filter/index.html index 5f6da8c84c..1894ac6f4c 100644 --- a/files/fr/web/javascript/reference/global_objects/array/filter/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/filter/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/filter <div>{{EmbedInteractiveExample("pages/js/array-filter.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.filter(<var>callback)</var>; // callback(elementCourant[, index[, tableauEntier]]) diff --git a/files/fr/web/javascript/reference/global_objects/array/find/index.html b/files/fr/web/javascript/reference/global_objects/array/find/index.html index e78c6d62a2..19ef805ebd 100644 --- a/files/fr/web/javascript/reference/global_objects/array/find/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/find/index.html @@ -18,7 +18,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/find <div>{{EmbedInteractiveExample("pages/js/array-find.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + <p>Voir aussi la méthode {{jsxref("Array.findIndex", "findIndex()")}} qui renvoie l'<strong>index</strong> de l'élément trouvé et non sa valeur. Si on souhaite repérer la position d'un élément donné dans le tableau, on pourra utiliser {{jsxref("Array.prototype.indexOf()")}}. Si on souhaite déterminer si un tableau contient un élément donné, on pourra utiliser la méthode {{jsxref("Array.prototype.includes()")}}.</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/findindex/index.html b/files/fr/web/javascript/reference/global_objects/array/findindex/index.html index 058e2d5975..9564b24021 100644 --- a/files/fr/web/javascript/reference/global_objects/array/findindex/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/findindex/index.html @@ -18,7 +18,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/findIndex <div>{{EmbedInteractiveExample("pages/js/array-findindex.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + <p>Voir également la méthode {{jsxref("Array.find", "find()")}} qui renvoie la <strong>valeur</strong> (et non l'indice) d'un des éléments trouvés.</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/flat/index.html b/files/fr/web/javascript/reference/global_objects/array/flat/index.html index e7e0d9e95f..160e1c350b 100644 --- a/files/fr/web/javascript/reference/global_objects/array/flat/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/flat/index.html @@ -14,10 +14,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flat <p>La méthode <code><strong>flat()</strong></code> permet de créer un nouveau tableau contenant les éléments des sous-tableaux du tableau passé en argument, qui sont concaténés récursivement pour atteindre une profondeur donnée.</p> -<p class="hidden">\{{EmbedInteractiveExample("pages/js/array-flatten.html")}}</p> - -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>var nouveauTableau = monTableau</var>.flat([<var>profondeur</var>]);</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/flatmap/index.html b/files/fr/web/javascript/reference/global_objects/array/flatmap/index.html index d0049d6c3c..4117829f18 100644 --- a/files/fr/web/javascript/reference/global_objects/array/flatmap/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/flatmap/index.html @@ -14,10 +14,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flatMap <p>La méthode <code><strong>flatMap()</strong></code> permet d'appliquer une fonction à chaque élément du tableau puis d'aplatir le résultat en un tableau. Cela correspond à l'enchaînement de {{jsxref("Array.prototype.map()")}} suivi de {{jsxref("Array.prototype.flat()")}} de profondeur 1. <code>flatMap</code> est plus efficace que la combinaison de ces deux opérations, souvent réalisées conjointement.</p> -<p class="hidden">\{{EmbedInteractiveExample("pages/js/array-flatmap.html")}}</p> - -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>var new_array = arr</var>.flatMap(function <var>callback(currentValue[, index[, array]]) { @@ -30,7 +26,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flatMap <dt><code>callback</code></dt> <dd>La fonction qui produit un élément du nouveau tableau et qui prend trois arguments : <dl> - <dt></dt> <dt><code>currentValue</code></dt> <dd>La valeur du tableau qui est traitée.</dd> <dt><code>index</code>{{optional_inline}}</dt> @@ -55,13 +50,13 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flatMap <h3 id="map_et_flatMap"><code>map()</code> et <code>flatMap()</code></h3> -<pre class="brush: js">var arr1 = <span class="js source"><span class="function-call js meta"><span class="js meta"><span class="brace js meta square"><span>[</span></span><span class="constant decimal js numeric"><span>1</span></span><span class="comma delimiter js meta object"><span>,</span></span><span> </span><span class="brace js meta square"><span>2, 3, 4]; +<pre class="brush: js">var arr1 = [1, 2, 3, 4]; -arr1.map(</span></span></span></span></span>x => [x * 2]<span class="js source"><span class="function-call js meta"><span class="js meta"><span class="brace js meta square"><span>);</span></span></span></span></span> +arr1.map(x => [x * 2]); // [[2], [4], [6], [8]] -arr1.flatMap(x => [x * 2]<span class="js source"><span class="function-call js meta"><span class="js meta"><span class="brace js meta square"><span>); -// [2, 4, 6, 8]</span></span></span></span></span> +arr1.flatMap(x => [x * 2]); +// [2, 4, 6, 8] // seul un niveau est aplati arr1.flatMap(x => [[x * 2]]); @@ -81,18 +76,18 @@ tableau1.flatMap(x => x.split(" ")); <p>On notera que la longueur de la liste obtenue avec <code>flatMap</code> est différente de la longueur de la liste originale.</p> -<div class="line"><span class="js source"><span class="comment double-slash js line"><span class="comment definition js punctuation"><span>//</span></span><span>=> [1, 2, 3, 4, 5, 6, 7, 8, 9]</span></span></span></div> +<pre>//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]</pre> <h2 id="Équivalent">Équivalent</h2> <h3 id="reduce_et_concat"><code>reduce()</code> et <code>concat()</code></h3> -<pre class="brush: js line-numbers language-js"><code class="language-js"><span class="keyword token">var</span> arr <span class="operator token">=</span> <span class="punctuation token">[</span><span class="number token">1</span><span class="punctuation token">,</span> <span class="number token">2</span><span class="punctuation token">,</span> <span class="number token">3</span><span class="punctuation token">,</span> <span class="number token">4</span><span class="punctuation token">]</span><span class="punctuation token">;</span> +<pre class="brush: js">var arr = [1, 2, 3, 4]; -arr<span class="punctuation token">.</span><span class="function token">flatMap</span><span class="punctuation token">(</span>x <span class="operator token">=</span><span class="operator token">></span> <span class="punctuation token">[x, </span>x <span class="operator token">*</span> <span class="number token">2</span><span class="punctuation token">]</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// est équivalent à</span> -arr<span class="punctuation token">.</span><span class="function token">reduce</span><span class="punctuation token">(</span><span class="punctuation token">(</span>acc<span class="punctuation token">,</span> x<span class="punctuation token">)</span> <span class="operator token">=</span><span class="operator token">></span> acc<span class="punctuation token">.</span><span class="function token">concat</span><span class="punctuation token">(</span><span class="punctuation token">[x, </span>x <span class="operator token">*</span> <span class="number token">2</span><span class="punctuation token">]</span><span class="punctuation token">)</span><span class="punctuation token">,</span> <span class="punctuation token">[</span><span class="punctuation token">]</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// [1, 2, 2, 4, 3, 6, 4, 8]</span></code></pre> +arr.flatMap(x => [x, x * 2]); +// est équivalent à +arr.reduce((acc, x) => acc.concat([x, x * 2]), []); +// [1, 2, 2, 4, 3, 6, 4, 8]</pre> <h2 id="Spécifications">Spécifications</h2> diff --git a/files/fr/web/javascript/reference/global_objects/array/foreach/index.html b/files/fr/web/javascript/reference/global_objects/array/foreach/index.html index c1653911b3..1b10baec33 100644 --- a/files/fr/web/javascript/reference/global_objects/array/foreach/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/foreach/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/forEach <div>{{EmbedInteractiveExample("pages/js/array-foreach.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.forEach(<var>callback</var>); @@ -67,9 +65,7 @@ arr.forEach(callback, <var>thisArg</var>);</pre> <p><code>forEach()</code> ne modifie pas le tableau sur lequel elle est appelée, en revanche, la fonction de retour (<em>callback</em>) utilisée peut modifier le tableau.</p> -<div class="note"><strong>Note :</strong> - -<p>Il n'existe aucun moyen d'arrêter une boucle <code>forEach</code> en dehors de lever une exception. Si vous avez besoin d'arrêter la boucle, étudiez plutôt :</p> +<div class="note"><p><strong>Note :</strong> Il n'existe aucun moyen d'arrêter une boucle <code>forEach</code> en dehors de lever une exception. Si vous avez besoin d'arrêter la boucle, étudiez plutôt :</p> <ul> <li>Une boucle <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/for">for</a></code> classique</li> @@ -110,7 +106,7 @@ items.forEach(function(item){ <h3 id="Afficher_le_contenu_d'un_tableau">Afficher le contenu d'un tableau</h3> -<div class="blockIndicator note"> +<div class="note"> <p><strong>Note :</strong> Pour afficher le contenu d'un tableau, on pourra utiliser <code><a href="/fr/docs/Web/API/Console/table">console.table()</a></code> qui met en forme les éléments du tableau. L'exemple suivant est laissé à titre d'illustration pour <code>forEach()</code>.</p> </div> @@ -155,7 +151,7 @@ console.log(obj.somme); // 16 </div> <div class="note"> -<p><strong>Note : </strong>Si la fonction passée en argument est <a href="/fr/docs/Web/JavaScript/Reference/Fonctions/Fonctions_fléchées">une fonction fléchée</a>, il n'est pas nécessaire d'ajouter le paramètre <code>this</code> car les fonctions fléchées utilisent le <code><a href="/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_this">this</a></code> fourni par le contexte lexical.</p> +<p><strong>Note :</strong> Si la fonction passée en argument est <a href="/fr/docs/Web/JavaScript/Reference/Fonctions/Fonctions_fléchées">une fonction fléchée</a>, il n'est pas nécessaire d'ajouter le paramètre <code>this</code> car les fonctions fléchées utilisent le <code><a href="/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_this">this</a></code> fourni par le contexte lexical.</p> </div> <h3 id="Stopper_une_boucle">Stopper une boucle</h3> diff --git a/files/fr/web/javascript/reference/global_objects/array/from/index.html b/files/fr/web/javascript/reference/global_objects/array/from/index.html index 588abb0596..de22e8feea 100644 --- a/files/fr/web/javascript/reference/global_objects/array/from/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/from/index.html @@ -17,8 +17,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/from <div>{{EmbedInteractiveExample("pages/js/array-from.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox">Array.from(arrayLike [, fonctionMap[, thisArg]])</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/includes/index.html b/files/fr/web/javascript/reference/global_objects/array/includes/index.html index 0758f0a693..e63134919f 100644 --- a/files/fr/web/javascript/reference/global_objects/array/includes/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/includes/index.html @@ -17,7 +17,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/includes <div>{{EmbedInteractiveExample("pages/js/array-includes.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + <div class="note"> <p><strong>Note :</strong> Cette méthode utilise l'algorithme de comparaison <em><a href="/fr/docs/Web/JavaScript/Les_différents_tests_d_égalité#Un_modèle_pour_mieux_comprendre">SameValueZero</a></em> qui fonctionne comme l'égalité stricte, à la différence que <code>NaN</code> est ici égal à lui même.</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/index.html b/files/fr/web/javascript/reference/global_objects/array/index.html index 5e8a0ebf2b..3604ce3910 100644 --- a/files/fr/web/javascript/reference/global_objects/array/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/index.html @@ -14,83 +14,94 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array <p><strong>Créer un tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> fruits <span class="operator token">=</span> <span class="punctuation token">[</span><span class="string token">'Apple'</span><span class="punctuation token">,</span> <span class="string token">'Banana'</span><span class="punctuation token">]</span><span class="punctuation token">;</span> +<pre class="brush: js">var fruits = ['Apple', 'Banana']; -console<span class="punctuation token">.</span><span class="function token">log</span><span class="punctuation token">(</span>fruits<span class="punctuation token">.</span>length<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// 2</span></code></pre> +console.log(fruits.length); +// 2 +</pre> <p><strong>Accéder (via son index) à un élément du tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> first <span class="operator token">=</span> fruits<span class="punctuation token">[</span><span class="number token">0</span><span class="punctuation token">]</span><span class="punctuation token">;</span> -<span class="comment token">// Apple</span> +<pre class="brush: js">var first = fruits[0]; +// Apple -<span class="keyword token">var</span> last <span class="operator token">=</span> fruits<span class="punctuation token">[</span>fruits<span class="punctuation token">.</span>length <span class="operator token">-</span> <span class="number token">1</span><span class="punctuation token">]</span><span class="punctuation token">;</span> -<span class="comment token">// Banana</span></code></pre> +var last = fruits[fruits.length - 1]; +// Banana +</pre> <p><strong>Boucler sur un tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js">fruits<span class="punctuation token">.</span><span class="function token">forEach</span><span class="punctuation token">(</span><span class="keyword token">function</span><span class="punctuation token">(</span>item<span class="punctuation token">,</span> index<span class="punctuation token">,</span> array<span class="punctuation token">)</span> <span class="punctuation token">{</span> - console<span class="punctuation token">.</span><span class="function token">log</span><span class="punctuation token">(</span>item<span class="punctuation token">,</span> index<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// Apple 0</span> -<span class="comment token">// Banana 1</span></code></pre> +<pre class="brush: js">fruits.forEach(function(item, index, array) { + console.log(item, index); +}); +// Apple 0 +// Banana 1 +</pre> <p><strong>Ajouter à la fin du tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> newLength <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">push</span><span class="punctuation token">(</span><span class="string token">'Orange'</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// ["Apple", "Banana", "Orange"]</span></code></pre> +<pre class="brush: js">var newLength = fruits.push('Orange'); +// ["Apple", "Banana", "Orange"] +</pre> <p><strong>Supprimer le dernier élément du tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> last <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">pop</span><span class="punctuation token">(</span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="comment token">// supprime Orange (à la fin)</span> -<span class="comment token">// ["Apple", "Banana"];</span></code></pre> +<pre class="brush: js">var last = fruits.pop(); // supprime Orange (à la fin) +// ["Apple", "Banana"]; +</pre> <p><strong>Supprimer le premier élément du tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> first <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">shift</span><span class="punctuation token">(</span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="comment token">// supprime Apple (au début)</span> -<span class="comment token">// ["Banana"];</span></code></pre> +<pre class="brush: js">var first = fruits.shift(); // supprime Apple (au début) +// ["Banana"]; +</pre> <p><strong>Ajouter au début du tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> newLength <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">unshift</span><span class="punctuation token">(</span><span class="string token">'Strawberry'</span><span class="punctuation token">)</span> <span class="comment token">// ajoute au début</span> -<span class="comment token">// ["Strawberry", "Banana"];</span></code></pre> +<pre class="brush: js">var newLength = fruits.unshift('Strawberry') // ajoute au début +// ["Strawberry", "Banana"]; +</pre> <p><strong>Trouver l'index d'un élément dans le tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js">fruits<span class="punctuation token">.</span><span class="function token">push</span><span class="punctuation token">(</span><span class="string token">'Mango'</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// ["Strawberry", "Banana", "Mango"]</span> +<pre class="brush: js">fruits.push('Mango'); +// ["Strawberry", "Banana", "Mango"] -<span class="keyword token">var</span> pos <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">indexOf</span><span class="punctuation token">(</span><span class="string token">'Banana'</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// 1</span></code></pre> +var pos = fruits.indexOf('Banana'); +// 1 +</pre> <p><strong>Supprimer un élément par son index</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> removedItem <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">splice</span><span class="punctuation token">(</span>pos<span class="punctuation token">,</span> <span class="number token">1</span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="comment token">// supprime 1 élément à la position pos</span> +<pre class="brush: js">var removedItem = fruits.splice(pos, 1); // supprime 1 élément à la position pos -<span class="comment token">// ["Strawberry", "Mango"]</span></code></pre> +// ["Strawberry", "Mango"] +</pre> <p><strong>Supprimer des éléments à partir d'un index</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> vegetables <span class="operator token">=</span> <span class="punctuation token">[</span><span class="string token">'Cabbage'</span><span class="punctuation token">,</span> <span class="string token">'Turnip'</span><span class="punctuation token">,</span> <span class="string token">'Radish'</span><span class="punctuation token">,</span> <span class="string token">'Carrot'</span><span class="punctuation token">]</span><span class="punctuation token">;</span> -console<span class="punctuation token">.</span><span class="function token">log</span><span class="punctuation token">(</span>vegetables<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// ["Cabbage", "Turnip", "Radish", "Carrot"]</span> +<pre class="brush: js">var vegetables = ['Cabbage', 'Turnip', 'Radish', 'Carrot']; +console.log(vegetables); +// ["Cabbage", "Turnip", "Radish", "Carrot"] -<span class="keyword token">var</span> pos <span class="operator token">=</span> <span class="number token">1</span><span class="punctuation token">,</span> n <span class="operator token">=</span> <span class="number token">2</span><span class="punctuation token">;</span> +var pos = 1, n = 2; -<span class="keyword token">var</span> removedItems <span class="operator token">=</span> vegetables<span class="punctuation token">.</span><span class="function token">splice</span><span class="punctuation token">(</span>pos<span class="punctuation token">,</span> n<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// n définit le nombre d'éléments à supprimer,</span> -<span class="comment token">// à partir de la position pos</span> +var removedItems = vegetables.splice(pos, n); +// n définit le nombre d'éléments à supprimer, +// à partir de la position pos -console<span class="punctuation token">.</span><span class="function token">log</span><span class="punctuation token">(</span>vegetables<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// ["Cabbage", "Carrot"] (le tableau d'origine est changé)</span> +console.log(vegetables); +// ["Cabbage", "Carrot"] (le tableau d'origine est changé) -console<span class="punctuation token">.</span><span class="function token">log</span><span class="punctuation token">(</span>removedItems<span class="punctuation token">)</span><span class="punctuation token">;</span> -<span class="comment token">// ["Turnip", "Radish"] (splice retourne la liste des éléments supprimés)</span></code></pre> +console.log(removedItems); +// ["Turnip", "Radish"] (splice retourne la liste des éléments supprimés) +</pre> <p><strong>Copier un tableau</strong></p> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js"><span class="keyword token">var</span> shallowCopy <span class="operator token">=</span> fruits<span class="punctuation token">.</span><span class="function token">slice</span><span class="punctuation token">(</span><span class="punctuation token">)</span><span class="punctuation token">;</span> <span class="comment token">// crée un nouveau tableau qui contient les éléments de fruits</span> -<span class="comment token">// ["Strawberry", "Mango"]</span></code></pre> +<pre class="brush: js">var shallowCopy = fruits.slice(); // crée un nouveau tableau qui contient les éléments de fruits +// ["Strawberry", "Mango"] +</pre> <h2 id="Syntaxe">Syntaxe</h2> @@ -98,14 +109,12 @@ console<span class="punctuation token">.</span><span class="function token">log< new Array(<var>element0</var>, <var>element1</var>[, ...[, <var>elementN</var>]]) new Array(<var>arrayLength</var>)</pre> +<h3 id="Paramètres">Paramètres</h3> <dl> - <dt> - <h3 id="Paramètres">Paramètres</h3> - </dt> <dt><code><var>element0</var>, <var>element1</var>, ..., <var>elementN</var> </code></dt> <dd>Un tableau est initialisé avec les éléments donnés, sauf dans le cas où un seul argument est passé au constructeur <code>Array</code> et que cet argument est un nombre. (Voir ci-après.) Notez que ce cas spécial s'applique aux tableaux créés avec le constructeur <code>Array</code>, et non aux tableaux créés avec la syntaxe crochets.</dd> <dt><code><var>arrayLength</var></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), un nouveau tableau sera créé avec ce nombre d'éléments (note : le tableau sera créé avec <code>arrayLength</code> emplacements vides, et non avec de véritables valeurs <code>undefined</code>). Si l'argument est un nombre en dehors de la plage autorisée, une exception {{jsxref("RangeError")}} est levée.</dd> + <dd>Si le seul argument passé au constructeur <code>Array</code> est un entier entre 0 et 2^32-1 (inclus), un nouveau tableau sera créé avec ce nombre d'éléments (note : le tableau sera créé avec <code>arrayLength</code> emplacements vides, et non avec de véritables valeurs <code>undefined</code>). Si l'argument est un nombre en dehors de la plage autorisée, une exception {{jsxref("RangeError")}} est levée.</dd> </dl> <h2 id="Description">Description</h2> @@ -153,7 +162,7 @@ renderer["3d"].setTexture(model, "personnage.png");// fonctionne correctement </ console.log(promise['var']);</pre> <div class="note"> -<p><strong>Note spécifique à Firefox :</strong> Depuis Firefox 40.0a2, il est possible d'utiliser la notation avec le point pour accéder aux propriétés dont les noms ne sont pas des identifiants valides.</p> +<p><strong>Note :</strong> Depuis Firefox 40.0a2, il est possible d'utiliser la notation avec le point pour accéder aux propriétés dont les noms ne sont pas des identifiants valides.</p> </div> <h3 id="Relation_entre_length_et_les_propriétés_numériques">Relation entre <code>length</code> et les propriétés numériques</h3> @@ -369,18 +378,19 @@ t,c,f,k,r,f,c,t <h3 id="Utiliser_un_tableau_pour_tabuler_un_ensemble_de_valeurs">Utiliser un tableau pour tabuler un ensemble de valeurs</h3> -<pre class="brush: js line-numbers language-js notranslate"><code class="language-js">values <span class="operator token">=</span> <span class="punctuation token">[</span><span class="punctuation token">]</span><span class="punctuation token">;</span> -<span class="keyword token">for</span> <span class="punctuation token">(</span><span class="keyword token">var</span> x <span class="operator token">=</span> <span class="number token">0</span><span class="punctuation token">;</span> x <span class="operator token"><</span> <span class="number token">10</span><span class="punctuation token">;</span> x<span class="operator token">++</span><span class="punctuation token">)</span><span class="punctuation token">{</span> - values<span class="punctuation token">.</span><span class="function token">push</span><span class="punctuation token">(</span><span class="punctuation token">[</span> - <span class="number token">2</span> <span class="operator token">*</span><span class="operator token">*</span> x<span class="punctuation token">,</span> - <span class="number token">2</span> <span class="operator token">*</span> x <span class="operator token">*</span><span class="operator token">*</span> <span class="number token">2</span> - <span class="punctuation token">]</span><span class="punctuation token">)</span> -<span class="punctuation token">}</span><span class="punctuation token">;</span> -console<span class="punctuation token">.</span><span class="function token">table</span><span class="punctuation token">(</span>values<span class="punctuation token">)</span></code></pre> +<pre class="brush: js">values = []; +for (var x = 0; x < 10; x++){ + values.push([ + 2 ** x, + 2 * x ** 2 + ]) +}; +console.table(values) +</pre> <p>Résulte en</p> -<pre class="eval line-numbers language-html notranslate"><code class="language-html">0 1 0 +<pre class="brush: plain">0 1 0 1 2 2 2 4 8 3 8 18 @@ -389,7 +399,8 @@ console<span class="punctuation token">.</span><span class="function token">tabl 6 64 72 7 128 98 8 256 128 -9 512 162</code></pre> +9 512 162 +</pre> <p>(Le première colonne est l'index)</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/indexof/index.html b/files/fr/web/javascript/reference/global_objects/array/indexof/index.html index d060a358f8..cdd545abc9 100644 --- a/files/fr/web/javascript/reference/global_objects/array/indexof/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/indexof/index.html @@ -21,8 +21,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/indexOf <div>{{EmbedInteractiveExample("pages/js/array-indexof.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.indexOf(<var>élémentRecherché</var>) diff --git a/files/fr/web/javascript/reference/global_objects/array/join/index.html b/files/fr/web/javascript/reference/global_objects/array/join/index.html index 5d554ff1d9..cdb8f6b0f6 100644 --- a/files/fr/web/javascript/reference/global_objects/array/join/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/join/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/join <div>{{EmbedInteractiveExample("pages/js/array-join.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.join() diff --git a/files/fr/web/javascript/reference/global_objects/array/keys/index.html b/files/fr/web/javascript/reference/global_objects/array/keys/index.html index 3f1206072e..88e747da9c 100644 --- a/files/fr/web/javascript/reference/global_objects/array/keys/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/keys/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/keys <div>{{EmbedInteractiveExample("pages/js/array-keys.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.keys()</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/lastindexof/index.html b/files/fr/web/javascript/reference/global_objects/array/lastindexof/index.html index 2ecc86a7b6..eb2c70d644 100644 --- a/files/fr/web/javascript/reference/global_objects/array/lastindexof/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/lastindexof/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/lastIndexOf <div>{{EmbedInteractiveExample("pages/js/array-lastindexof.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.lastIndexOf(<var>élémentRecherché</var>) diff --git a/files/fr/web/javascript/reference/global_objects/array/length/index.html b/files/fr/web/javascript/reference/global_objects/array/length/index.html index f4a6f35fdd..4e05fe8940 100644 --- a/files/fr/web/javascript/reference/global_objects/array/length/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/length/index.html @@ -15,11 +15,11 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/length <div>{{EmbedInteractiveExample("pages/js/array-length.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + <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<sup>32</sup>).</p> +<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 var tableauC = new Array(-100) // une valeur négative diff --git a/files/fr/web/javascript/reference/global_objects/array/map/index.html b/files/fr/web/javascript/reference/global_objects/array/map/index.html index a98f3a6198..48a9be07f5 100644 --- a/files/fr/web/javascript/reference/global_objects/array/map/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/map/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/map <div>{{EmbedInteractiveExample("pages/js/array-map.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>var nouveauTableau = arr</var>.map(<var>callback</var> [, <var>thisArg</var>])</pre> @@ -53,7 +51,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/map <p><code>callback</code> est appelée avec trois arguments : la valeur de l'élément du tableau, l'index de cet élément et l'objet {{jsxref("Array")}} qui est parcouru.</p> <div class="warning"> -<p><strong>Attention !</strong> <code>map()</code> construit un nouveau tableau. Si on utilise cette méthode sans utiliser le résultat, mieux vaudra utiliser <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array/forEach">forEach</a></code> ou <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/for...of">for...of</a></code>. Pour mieux décider si <code>map()</code>est adéquat, regardez si vous utilisez la valeur de retour et/ou si vous renvoyez une valeur avec la fonction <code>callback</code> : si ce n'est pas le cas, il ne faut pas utiliser <code>map()</code>.</p> +<p><strong>Attention :</strong> <code>map()</code> construit un nouveau tableau. Si on utilise cette méthode sans utiliser le résultat, mieux vaudra utiliser <code><a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array/forEach">forEach</a></code> ou <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/for...of">for...of</a></code>. Pour mieux décider si <code>map()</code>est adéquat, regardez si vous utilisez la valeur de retour et/ou si vous renvoyez une valeur avec la fonction <code>callback</code> : si ce n'est pas le cas, il ne faut pas utiliser <code>map()</code>.</p> </div> <p>Si le paramètre <code>thisArg</code> est utilisé, il sera utilisé en tant que <code>this</code> par la fonction <code>callback</code> lorsqu'elle sera appelée. S'il n'est pas utilisé, ce sera la valeur {{jsxref("undefined")}} qui sera utilisée pour définir <code>this</code>. La valeur <code>this</code> finalement prise en compte par la fonction <code>callback</code> est définie <a href="/fr/docs/Web/JavaScript/Reference/Op%C3%A9rateurs/L_op%C3%A9rateur_this">selon les règles usuelles qui déterminent la valeur <code>this</code> observée par une fonction</a>.</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/pop/index.html b/files/fr/web/javascript/reference/global_objects/array/pop/index.html index d2d0a2d0f2..6a5345dd88 100644 --- a/files/fr/web/javascript/reference/global_objects/array/pop/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/pop/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/pop <div>{{EmbedInteractiveExample("pages/js/array-pop.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.pop()</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/push/index.html b/files/fr/web/javascript/reference/global_objects/array/push/index.html index 455bc6274e..c7f18ce86b 100644 --- a/files/fr/web/javascript/reference/global_objects/array/push/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/push/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/push <div>{{EmbedInteractiveExample("pages/js/array-push.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.push(<var>élément1</var>, ..., <var>élémentN</var>)</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/reduce/index.html b/files/fr/web/javascript/reference/global_objects/array/reduce/index.html index 04cb6db277..6ec6af3488 100644 --- a/files/fr/web/javascript/reference/global_objects/array/reduce/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/reduce/index.html @@ -17,8 +17,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/reduce <div>{{EmbedInteractiveExample("pages/js/array-reduce.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.reduce(<var>callback</var>) diff --git a/files/fr/web/javascript/reference/global_objects/array/reduceright/index.html b/files/fr/web/javascript/reference/global_objects/array/reduceright/index.html index 0244f4ff76..63222a2191 100644 --- a/files/fr/web/javascript/reference/global_objects/array/reduceright/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/reduceright/index.html @@ -17,7 +17,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/reduceRight <div>{{EmbedInteractiveExample("pages/js/array-reduce-right.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> + <p>Voir également {{jsxref("Array.prototype.reduce()")}} pour une méthode qui réduit de gauche à droite.</p> diff --git a/files/fr/web/javascript/reference/global_objects/array/reverse/index.html b/files/fr/web/javascript/reference/global_objects/array/reverse/index.html index 37248af1ac..cfd6d0029a 100644 --- a/files/fr/web/javascript/reference/global_objects/array/reverse/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/reverse/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/reverse <div>{{EmbedInteractiveExample("pages/js/array-reverse.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.reverse()</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/shift/index.html b/files/fr/web/javascript/reference/global_objects/array/shift/index.html index 01ed662525..aa853937b2 100644 --- a/files/fr/web/javascript/reference/global_objects/array/shift/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/shift/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/shift <div>{{EmbedInteractiveExample("pages/js/array-shift.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.shift()</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/slice/index.html b/files/fr/web/javascript/reference/global_objects/array/slice/index.html index 329a249197..988565123b 100644 --- a/files/fr/web/javascript/reference/global_objects/array/slice/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/slice/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/slice <div>{{EmbedInteractiveExample("pages/js/array-slice.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.slice() @@ -29,18 +27,11 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/slice <dl> <dt><code>début</code> {{optional_inline}}</dt> - <dd>Indice (à partir de zéro) depuis lequel commencer l'extraction.</dd> - <dd>S'il s'agit d'un indice négatif, <code>début</code> indique un décalage depuis la fin de la séquence. Par exemple, <code>slice(-2)</code> extrait les avant-dernier et dernier éléments dans la séquence.<br> + <dd>Indice (à partir de zéro) depuis lequel commencer l'extraction. S'il s'agit d'un indice négatif, <code>début</code> indique un décalage depuis la fin de la séquence. Par exemple, <code>slice(-2)</code> extrait les avant-dernier et dernier éléments dans la séquence.<br> <br> Si <code>début</code> est absent, <code>slice()</code> commencera depuis 0. Si <code>début</code> est supérieur à la taille du tableau, c'est un tableau vide qui sera renvoyé.</dd> -</dl> - -<dl> <dt><code>fin</code> {{optional_inline}}</dt> - <dd>Indice (à partir de zéro) auquel arrêter l'extraction. <code>slice()</code> extrait jusqu'à cet indice, mais pas l'élément situé en <code>fin</code> lui-même.</dd> - <dd><code>slice(1,4)</code> extrait du deuxième au quatrième élément (les éléments d'indices 1, 2 et 3).</dd> - <dd>S'il s'agit d'un indice négatif, <code>fin</code> indique un décalage depuis la fin de la séquence. <code>slice(2,-1)</code> extrait du troisième à l'avant-dernier élément dans la séquence.</dd> - <dd>Si <code>fin</code> n'est pas fourni, <code>slice()</code> extraira jusqu'à la fin de la séquence (<code>arr.length</code>). Si <code>fin</code> est supérieur à la longueur de la séquence, <code>slice()</code> fera une extraction jusqu'à la fin de la séquence.</dd> + <dd>Indice (à partir de zéro) auquel arrêter l'extraction. <code>slice()</code> extrait jusqu'à cet indice, mais pas l'élément situé en <code>fin</code> lui-même. <code>slice(1,4)</code> extrait du deuxième au quatrième élément (les éléments d'indices 1, 2 et 3). S'il s'agit d'un indice négatif, <code>fin</code> indique un décalage depuis la fin de la séquence. <code>slice(2,-1)</code> extrait du troisième à l'avant-dernier élément dans la séquence. Si <code>fin</code> n'est pas fourni, <code>slice()</code> extraira jusqu'à la fin de la séquence (<code>arr.length</code>). Si <code>fin</code> est supérieur à la longueur de la séquence, <code>slice()</code> fera une extraction jusqu'à la fin de la séquence.</dd> </dl> <h3 id="Valeur_de_retour">Valeur de retour</h3> diff --git a/files/fr/web/javascript/reference/global_objects/array/some/index.html b/files/fr/web/javascript/reference/global_objects/array/some/index.html index e91e4624e6..b9a15a2855 100644 --- a/files/fr/web/javascript/reference/global_objects/array/some/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/some/index.html @@ -22,8 +22,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/some <div>{{EmbedInteractiveExample("pages/js/array-some.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.some(<var>callback</var>[, <var>objetThis</var>])</pre> diff --git a/files/fr/web/javascript/reference/global_objects/array/sort/index.html b/files/fr/web/javascript/reference/global_objects/array/sort/index.html index 600e2a9489..84ce52113f 100644 --- a/files/fr/web/javascript/reference/global_objects/array/sort/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/sort/index.html @@ -18,8 +18,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/sort <div>{{EmbedInteractiveExample("pages/js/array-sort.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuer à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.sort() @@ -40,7 +38,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/sort <p>Si le paramètre <code>fonctionComparaison</code> n'est pas fourni, les éléments qui ne valent pas <code>undefined</code> sont triés en les convertissant en chaines de caractères et en comparant ces chaines selon l'ordre des points de code Unicode. Par exemple, "banane" sera trié avant "cerise", mais "Cerise" arrivera avant "banane" à cause de la majuscule (les majuscules arrivent avant dans la liste). Dans un tri numérique, 9 sera trié avant 80, mais comme ces nombres sont convertis en chaînes de caractères, "80" arrive avant "9" selon l'ordre des unités de code UTF-16. Les éléments valant <code>undefined</code> sont placés à la fin du tableau.</p> -<div class="blockIndicator note"> +<div class="note"> <p><strong>Note :</strong> En UTF-16, les caractères Unicode situés après <code>\uFFFF</code> sont encodés avec deux unités de code <em>surrogates</em> sur l'intervalle <code>\uD800</code>-<code>\uDFFF</code>. Pour comparer les chaînes de caractères entre elles, ce sont les unités de code séparées qui sont prises en compte. Ainsi, le caractère formé par la paire <em>surrogate</em> <code>\uD655 \uDE55</code> sera trié avant le caractère <code>\uFF3A</code>.</p> </div> @@ -234,8 +232,8 @@ var result = mapped.map(function(e){ }); </pre> -<div class="blockIndicator note"> -<p><strong>Note : </strong>Une bibliothèque <em>open source</em> utilise cette approche : <code><a href="https://null.house/open-source/mapsort">mapsort</a></code>.</p> +<div class="note"> +<p><strong>Note :</strong> Une bibliothèque <em>open source</em> utilise cette approche : <code><a href="https://null.house/open-source/mapsort">mapsort</a></code>.</p> </div> <h2 id="Spécifications">Spécifications</h2> diff --git a/files/fr/web/javascript/reference/global_objects/array/splice/index.html b/files/fr/web/javascript/reference/global_objects/array/splice/index.html index b01ec5cb79..a4fc4f2ad5 100644 --- a/files/fr/web/javascript/reference/global_objects/array/splice/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/splice/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/splice <div>{{EmbedInteractiveExample("pages/js/array-splice.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>var tabElementsSupprimes = array</var>.splice(<var>début</var>, nbASupprimer[, <var>élem1</var>[, élem2[, ...]]]) @@ -27,19 +25,10 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/splice <dl> <dt><code>début</code></dt> - <dd>L'indice à partir duquel commencer à changer le tableau (l'indice du premier élement étant <code>0</code>).</dd> - <dd>Si sa valeur est supérieure à la longueur du tableau <code><var>array</var>.length</code>, <code>début</code> est ramené à la longueur du tableau <code><var>array</var>.length</code>.</dd> - <dd>S'il est négatif, le changement commencera d'autant d'éléments à partir de la fin du tableau, c'est à dire à partir de l'index <code><var>array</var>.length + <var>début</var></code>. Si <code><var>array</var>.length + <var>début</var></code> est inférieur à <code>0</code>, le changement commencera à l'index <code>0</code>.</dd> -</dl> - -<dl> + <dd>L'indice à partir duquel commencer à changer le tableau (l'indice du premier élement étant <code>0</code>). Si sa valeur est supérieure à la longueur du tableau <code><var>array</var>.length</code>, <code>début</code> est ramené à la longueur du tableau <code><var>array</var>.length</code>. S'il est négatif, le changement commencera d'autant d'éléments à partir de la fin du tableau, c'est à dire à partir de l'index <code><var>array</var>.length + <var>début</var></code>. Si <code><var>array</var>.length + <var>début</var></code> est inférieur à <code>0</code>, le changement commencera à l'index <code>0</code>.</dd> <dt><code>nbASupprimer</code></dt> <dd>Un entier indiquant le nombre d'anciens éléments à remplacer.<br> - Si ce paramètre est absent ou si sa valeur est supérieure ou égale à <code>array.length - début</code>, alors les éléments entre <code>début</code> et la fin du tableau seront supprimés.</dd> - <dd>Si <code>nbASupprimer</code> vaut 0, aucun élément ne sera supprimé. Dans ce cas, il est nécessaire de spécifier au moins un nouvel élément.</dd> -</dl> - -<dl> + Si ce paramètre est absent ou si sa valeur est supérieure ou égale à <code>array.length - début</code>, alors les éléments entre <code>début</code> et la fin du tableau seront supprimés. Si <code>nbASupprimer</code> vaut 0, aucun élément ne sera supprimé. Dans ce cas, il est nécessaire de spécifier au moins un nouvel élément.</dd> <dt><code>élemN</code></dt> <dd>Les éléments à ajouter au tableau à partir de <code>début</code>. Si vous ne spécifiez pas de nouvel élément, les anciens éléments seront simplement supprimés du tableau.</dd> </dl> diff --git a/files/fr/web/javascript/reference/global_objects/array/tolocalestring/index.html b/files/fr/web/javascript/reference/global_objects/array/tolocalestring/index.html index 43fba5aaeb..8e790d06f6 100644 --- a/files/fr/web/javascript/reference/global_objects/array/tolocalestring/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/tolocalestring/index.html @@ -19,8 +19,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/toLocaleString <div>{{EmbedInteractiveExample("pages/js/array-tolocalestring.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.toLocaleString(); diff --git a/files/fr/web/javascript/reference/global_objects/array/tostring/index.html b/files/fr/web/javascript/reference/global_objects/array/tostring/index.html index 5976c40138..2c9944f5dd 100644 --- a/files/fr/web/javascript/reference/global_objects/array/tostring/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/tostring/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/toString <div>{{EmbedInteractiveExample("pages/js/array-tostring.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.toString()</pre> @@ -34,7 +32,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/toString <h3 id="Sémantique_d'ECMAScript_5">Sémantique d'ECMAScript 5</h3> -<p>À partir de JavaScript 1.8.5 (Firefox 4), et en cohérence avec la 5<sup>e</sup> édition d'ECMAScript, la méthode <code>toString()</code> est générique et peut être utilisé avec n'importe quel objet. {{jsxref("Object.prototype.toString()")}} sera appelée, et la valeur résultante sera renvoyée.</p> +<p>À partir de JavaScript 1.8.5 (Firefox 4), et en cohérence avec la 5e édition d'ECMAScript, la méthode <code>toString()</code> est générique et peut être utilisé avec n'importe quel objet. {{jsxref("Object.prototype.toString()")}} sera appelée, et la valeur résultante sera renvoyée.</p> <h2 id="Spécifications">Spécifications</h2> diff --git a/files/fr/web/javascript/reference/global_objects/array/unshift/index.html b/files/fr/web/javascript/reference/global_objects/array/unshift/index.html index 4d27cf8a79..77ba3d8eeb 100644 --- a/files/fr/web/javascript/reference/global_objects/array/unshift/index.html +++ b/files/fr/web/javascript/reference/global_objects/array/unshift/index.html @@ -16,8 +16,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/unshift <div>{{EmbedInteractiveExample("pages/js/array-unshift.html")}}</div> -<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p> - <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox"><var>arr</var>.unshift([<var>élém1</var>[, ...[, <var>élémN</var>]]])</pre> |