From 2a76c37d0e733dedf8ed87d1e7e46caf3c44667e Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Fri, 30 Jul 2021 20:18:17 +0200 Subject: Prepare JS French section for Markdown (#1574) * Rm IDs w/ [^h\d] id=" * Remove class="hidden" * Remove hidden for code blocks * rm summary classes * Use Note consistently * Remove sup * Rm code in pre * Fixes dd/dt/dl * Fix some more dd * Remove inline style and useless/craft from span/font * h2m report fixing - Consistent use of notes * h2m report fixing - Consistent use of warnings * h2m report fixing - reword one callout * h2m report fixing - array cruft spans hell * Cleaning the rest of docs for md conversion --- .../global_objects/array/array/index.html | 2 +- .../global_objects/array/concat/index.html | 2 - .../global_objects/array/copywithin/index.html | 8 +- .../global_objects/array/entries/index.html | 2 - .../global_objects/array/every/index.html | 2 - .../reference/global_objects/array/fill/index.html | 2 - .../global_objects/array/filter/index.html | 2 - .../reference/global_objects/array/find/index.html | 2 +- .../global_objects/array/findindex/index.html | 2 +- .../reference/global_objects/array/flat/index.html | 4 - .../global_objects/array/flatmap/index.html | 25 ++--- .../global_objects/array/foreach/index.html | 10 +- .../reference/global_objects/array/from/index.html | 2 - .../global_objects/array/includes/index.html | 2 +- .../reference/global_objects/array/index.html | 119 +++++++++++---------- .../global_objects/array/indexof/index.html | 2 - .../reference/global_objects/array/join/index.html | 2 - .../reference/global_objects/array/keys/index.html | 2 - .../global_objects/array/lastindexof/index.html | 2 - .../global_objects/array/length/index.html | 4 +- .../reference/global_objects/array/map/index.html | 4 +- .../reference/global_objects/array/pop/index.html | 2 - .../reference/global_objects/array/push/index.html | 2 - .../global_objects/array/reduce/index.html | 2 - .../global_objects/array/reduceright/index.html | 2 +- .../global_objects/array/reverse/index.html | 2 - .../global_objects/array/shift/index.html | 2 - .../global_objects/array/slice/index.html | 13 +-- .../reference/global_objects/array/some/index.html | 2 - .../reference/global_objects/array/sort/index.html | 8 +- .../global_objects/array/splice/index.html | 15 +-- .../global_objects/array/tolocalestring/index.html | 2 - .../global_objects/array/tostring/index.html | 4 +- .../global_objects/array/unshift/index.html | 2 - 34 files changed, 96 insertions(+), 164 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/array') 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(longueurTableau)
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 {{jsxref("RangeError")}} sera levée.
+
Si le seul argument passé au constructeur Array est un entier entre 0 et 2^32-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 {{jsxref("RangeError")}} sera levée.

Exemples

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
{{EmbedInteractiveExample("pages/js/array-concat.html")}}
- -

Syntaxe

let nouveau_tableau = ancien_tableau.concat(valeur1[, valeur2[, ...[, valeurN]]])
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
{{EmbedInteractiveExample("pages/js/array-copywithin.html")}}
- -

Syntaxe

arr.copyWithin(cible)
@@ -37,11 +35,9 @@ arr.copyWithin(cible, début, fin)
  
Si cible est supérieur ou égal à arr.length, rien ne sera copié. Si cible est positionné apès début, la séquence copiée sera réduite pour correspondre à arr.length.

  
  
début {{optional_inline}}

- 
Indice de début de la séquence a copier. Si la valeur est négative, début sera compté à partir de la fin du tableau.

- 
Si début est omis, copyWithin copiera à partir du début du tableau (par défaut 0).

+ 
Indice de début de la séquence a copier. Si la valeur est négative, début sera compté à partir de la fin du tableau. Si début est omis, copyWithin copiera à partir du début du tableau (par défaut 0).

  
fin {{optional_inline}}

- 
Indice de fin de la séquence a copier. copyWithin copie jusqu'à fin (non-inclusif). Si la valeur est négative, end sera compté à partir de la fin du tableau.

- 
Si end est omis, copyWithin copiera jusqu'à la fin du tableau (par défaut arr.length).

+ 
Indice de fin de la séquence a copier. copyWithin copie jusqu'à fin (non-inclusif). Si la valeur est négative, end sera compté à partir de la fin du tableau. Si end est omis, copyWithin copiera jusqu'à la fin du tableau (par défaut arr.length).

 
 
 
Valeur de retour

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
 
 
{{EmbedInteractiveExample("pages/js/array-entries.html")}}

 
-
-
 
Syntaxe

 
 
arr.entries()

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
 
 
{{EmbedInteractiveExample("pages/js/array-every.html")}}

 
-
-
 
Syntaxe

 
 
arr.every(callback[, thisArg])

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
 
 
{{EmbedInteractiveExample("pages/js/array-fill.html")}}

 
-
-
 
Syntaxe

 
 
arr.fill(valeur)
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
 
 
{{EmbedInteractiveExample("pages/js/array-filter.html")}}

 
-
-
 
Syntaxe

 
 
arr.filter(callback); // 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
 
 
{{EmbedInteractiveExample("pages/js/array-find.html")}}

 
-
+
 
 
Voir aussi la méthode {{jsxref("Array.findIndex", "findIndex()")}} qui renvoie l'index 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()")}}.

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-findindex.html")}}

 
-
+
 
 
Voir également la méthode {{jsxref("Array.find", "find()")}} qui renvoie la valeur (et non l'indice) d'un des éléments trouvés.

 
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
 
 
La méthode flat() 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.

 
-
-
-
-
 
Syntaxe

 
 
var nouveauTableau = monTableau.flat([profondeur]);

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
 
 
La méthode flatMap() 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. flatMap est plus efficace que la combinaison de ces deux opérations, souvent réalisées conjointement.

 
-
-
-
-
 
Syntaxe

 
 
var new_array = arr.flatMap(function callback(currentValue[, index[, array]]) {
@@ -30,7 +26,6 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flatMap
  
callback

  
La fonction qui produit un élément du nouveau tableau et qui prend trois arguments :
  

-  

   
currentValue

   
La valeur du tableau qui est traitée.

   
index{{optional_inline}}

@@ -55,13 +50,13 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/flatMap
 
 
map() et flatMap()

 
-
var arr1 = [1, 2, 3, 4];
+
var arr1 = [1, 2, 3, 4];
 
-arr1.map(x => [x * 2]);
+arr1.map(x => [x * 2]);
 // [[2], [4], [6], [8]]
 
-arr1.flatMap(x => [x * 2]);
-// [2, 4, 6, 8]
+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(" "));
 
 
On notera que la longueur de la liste obtenue avec flatMap est différente de la longueur de la liste originale.

 
-
//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]

+
//=> [1, 2, 3, 4, 5, 6, 7, 8, 9]

 
 
Équivalent

 
 
reduce() et concat()

 
-
var arr = [1, 2, 3, 4];
+
var arr = [1, 2, 3, 4];
 
-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]

+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]

 
 
Spécifications

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-foreach.html")}}

 
-
-
 
Syntaxe

 
 
arr.forEach(callback);
@@ -67,9 +65,7 @@ arr.forEach(callback, thisArg);

 
 
forEach() ne modifie pas le tableau sur lequel elle est appelée, en revanche, la fonction de retour (callback) utilisée peut modifier le tableau.

 
-
Note :
-
-
Il n'existe aucun moyen d'arrêter une boucle forEach en dehors de lever une exception. Si vous avez besoin d'arrêter la boucle, étudiez plutôt :

+
Note : Il n'existe aucun moyen d'arrêter une boucle forEach en dehors de lever une exception. Si vous avez besoin d'arrêter la boucle, étudiez plutôt :

 
 
    
  
  • Une boucle for classique
    • 
@@ -110,7 +106,7 @@ items.forEach(function(item){
 
 
    Afficher le contenu d'un tableau
    
 
-
    
+
    
 
    Note : Pour afficher le contenu d'un tableau, on pourra utiliser console.table() qui met en forme les éléments du tableau. L'exemple suivant est laissé à titre d'illustration pour forEach().
    
 
    
 
@@ -155,7 +151,7 @@ console.log(obj.somme);  // 16
 
    
 
 
    
-
    Note : Si la fonction passée en argument est une fonction fléchée, il n'est pas nécessaire d'ajouter le paramètre this car les fonctions fléchées utilisent le this fourni par le contexte lexical.
    
+
    Note : Si la fonction passée en argument est une fonction fléchée, il n'est pas nécessaire d'ajouter le paramètre this car les fonctions fléchées utilisent le this fourni par le contexte lexical.
    
 
    
 
 
    Stopper une boucle
    
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
 
 
    {{EmbedInteractiveExample("pages/js/array-from.html")}}
    
 
-
-
 
    Syntaxe
    
 
 
    Array.from(arrayLike [, fonctionMap[, thisArg]])
    
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
 
 
    {{EmbedInteractiveExample("pages/js/array-includes.html")}}
    
 
-
+
 
 
    
 
    Note : Cette méthode utilise l'algorithme de comparaison SameValueZero qui fonctionne comme l'égalité stricte, à la différence que NaN est ici égal à lui même.
    
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
 
 
    Créer un tableau
    
 
-
    var fruits = ['Apple', 'Banana'];
+
    var fruits = ['Apple', 'Banana'];
 
-console.log(fruits.length);
-// 2
    
+console.log(fruits.length);
+// 2
+
    
 
 
    Accéder (via son index) à un élément du tableau
    
 
-
    var first = fruits[0];
-// Apple
+
    var first = fruits[0];
+// Apple
 
-var last = fruits[fruits.length - 1];
-// Banana
    
+var last = fruits[fruits.length - 1];
+// Banana
+
    
 
 
    Boucler sur un tableau
    
 
-
    fruits.forEach(function(item, index, array) {
-  console.log(item, index);
-});
-// Apple 0
-// Banana 1
    
+
    fruits.forEach(function(item, index, array) {
+  console.log(item, index);
+});
+// Apple 0
+// Banana 1
+
    
 
 
    Ajouter à la fin du tableau
    
 
-
    var newLength = fruits.push('Orange');
-// ["Apple", "Banana", "Orange"]
    
+
    var newLength = fruits.push('Orange');
+// ["Apple", "Banana", "Orange"]
+
    
 
 
    Supprimer le dernier élément du tableau
    
 
-
    var last = fruits.pop(); // supprime Orange (à la fin)
-// ["Apple", "Banana"];
    
+
    var last = fruits.pop(); // supprime Orange (à la fin)
+// ["Apple", "Banana"];
+
    
 
 
    Supprimer le premier élément du tableau
    
 
-
    var first = fruits.shift(); // supprime Apple (au début)
-// ["Banana"];
    
+
    var first = fruits.shift(); // supprime Apple (au début)
+// ["Banana"];
+
    
 
 
    Ajouter au début du tableau
    
 
-
    var newLength = fruits.unshift('Strawberry') // ajoute au début
-// ["Strawberry", "Banana"];
    
+
    var newLength = fruits.unshift('Strawberry') // ajoute au début
+// ["Strawberry", "Banana"];
+
    
 
 
    Trouver l'index d'un élément dans le tableau
    
 
-
    fruits.push('Mango');
-// ["Strawberry", "Banana", "Mango"]
+
    fruits.push('Mango');
+// ["Strawberry", "Banana", "Mango"]
 
-var pos = fruits.indexOf('Banana');
-// 1
    
+var pos = fruits.indexOf('Banana');
+// 1
+
    
 
 
    Supprimer un élément par son index
    
 
-
    var removedItem = fruits.splice(pos, 1); // supprime 1 élément à la position pos
+
    var removedItem = fruits.splice(pos, 1); // supprime 1 élément à la position pos
 
-// ["Strawberry", "Mango"]
    
+// ["Strawberry", "Mango"]
+
    
 
 
    Supprimer des éléments à partir d'un index
    
 
-
    var vegetables = ['Cabbage', 'Turnip', 'Radish', 'Carrot'];
-console.log(vegetables);
-// ["Cabbage", "Turnip", "Radish", "Carrot"]
+
    var vegetables = ['Cabbage', 'Turnip', 'Radish', 'Carrot'];
+console.log(vegetables);
+// ["Cabbage", "Turnip", "Radish", "Carrot"]
 
-var pos = 1, n = 2;
+var pos = 1, n = 2;
 
-var removedItems = vegetables.splice(pos, n);
-// n définit le nombre d'éléments à supprimer,
-// à partir de la position pos
+var removedItems = vegetables.splice(pos, n);
+// n définit le nombre d'éléments à supprimer,
+// à partir de la position pos
 
-console.log(vegetables);
-// ["Cabbage", "Carrot"] (le tableau d'origine est changé)
+console.log(vegetables);
+// ["Cabbage", "Carrot"] (le tableau d'origine est changé)
 
-console.log(removedItems);
-// ["Turnip", "Radish"] (splice retourne la liste des éléments supprimés)
    
+console.log(removedItems);
+// ["Turnip", "Radish"] (splice retourne la liste des éléments supprimés)
+
    
 
 
    Copier un tableau
    
 
-
    var shallowCopy = fruits.slice(); // crée un nouveau tableau qui contient les éléments de fruits
-// ["Strawberry", "Mango"]
    
+
    var shallowCopy = fruits.slice(); // crée un nouveau tableau qui contient les éléments de fruits
+// ["Strawberry", "Mango"]
+
    
 
 
    Syntaxe
    
 
@@ -98,14 +109,12 @@ console.log<
 new Array(element0, element1[, ...[, elementN]])
 new Array(arrayLength)

 
+
Paramètres

 

- 

- 
Paramètres

- 

  
element0, element1, ..., elementN 

  
Un tableau est initialisé avec les éléments donnés, sauf dans le cas où un seul argument est passé au constructeur Array 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 Array, et non aux tableaux créés avec la syntaxe crochets.

  
arrayLength

- 
Si le seul argument passé au constructeur Array est un entier entre 0 et 232-1 (inclus), un nouveau tableau sera créé avec ce nombre d'éléments (note : le tableau sera créé avec arrayLength emplacements vides, et non avec de véritables valeurs undefined). Si l'argument est un nombre en dehors de la plage autorisée, une exception {{jsxref("RangeError")}} est levée.

+ 
Si le seul argument passé au constructeur Array 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 arrayLength emplacements vides, et non avec de véritables valeurs undefined). Si l'argument est un nombre en dehors de la plage autorisée, une exception {{jsxref("RangeError")}} est levée.

 

 
 
Description

@@ -153,7 +162,7 @@ renderer["3d"].setTexture(model, "personnage.png");// fonctionne correctement 
 
 

-
Note spécifique à Firefox : 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.

+
Note : 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.

 

 
 
Relation entre length et les propriétés numériques

@@ -369,18 +378,19 @@ t,c,f,k,r,f,c,t
 
 
Utiliser un tableau pour tabuler un ensemble de valeurs

 
-
values = [];
-for (var x = 0; x < 10; x++){
- values.push([
-  2 ** x,
-  2 * x ** 2
- ])
-};
-console.table(values)

+
values = [];
+for (var x = 0; x < 10; x++){
+ values.push([
+  2 ** x,
+  2 * x ** 2
+ ])
+};
+console.table(values)
+

 
 
Résulte en

 
-
0	1	0
+
0	1	0
 1	2	2
 2	4	8
 3	8	18
@@ -389,7 +399,8 @@ console.tabl
 6	64	72
 7	128	98
 8	256	128
-9	512	162

+9	512	162
+

 
 
(Le première colonne est l'index)

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-indexof.html")}}

 
-
-
 
Syntaxe

 
 
arr.indexOf(élémentRecherché)
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
 
 
{{EmbedInteractiveExample("pages/js/array-join.html")}}

 
-
-
 
Syntaxe

 
 
arr.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
 
 
{{EmbedInteractiveExample("pages/js/array-keys.html")}}

 
-
-
 
Syntaxe

 
 
arr.keys()

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
 
 
{{EmbedInteractiveExample("pages/js/array-lastindexof.html")}}

 
-
-
 
Syntaxe

 
 
arr.lastIndexOf(élémentRecherché)
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
 
 
{{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 (232).

+
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).

 
 
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
 
 
{{EmbedInteractiveExample("pages/js/array-map.html")}}

 
-
-
 
Syntaxe

 
 
var nouveauTableau = arr.map(callback [, thisArg])

@@ -53,7 +51,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/map
 
callback 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.

 
 

-
Attention ! map() construit un nouveau tableau. Si on utilise cette méthode sans utiliser le résultat, mieux vaudra utiliser forEach ou for...of.  Pour mieux décider si map()est adéquat, regardez si vous utilisez la valeur de retour et/ou si vous renvoyez une valeur avec la fonction callback : si ce n'est pas le cas, il ne faut pas utiliser map().

+
Attention : map() construit un nouveau tableau. Si on utilise cette méthode sans utiliser le résultat, mieux vaudra utiliser forEach ou for...of.  Pour mieux décider si map()est adéquat, regardez si vous utilisez la valeur de retour et/ou si vous renvoyez une valeur avec la fonction callback : si ce n'est pas le cas, il ne faut pas utiliser map().

 

 
 
Si le paramètre thisArg est utilisé, il sera utilisé en tant que this par la fonction callback lorsqu'elle sera appelée. S'il n'est pas utilisé, ce sera la valeur {{jsxref("undefined")}} qui sera utilisée pour définir this. La valeur this finalement prise en compte par la fonction callback est définie selon les règles usuelles qui déterminent la valeur this observée par une fonction.

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
 
 
{{EmbedInteractiveExample("pages/js/array-pop.html")}}

 
-
-
 
Syntaxe

 
 
arr.pop()

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
 
 
{{EmbedInteractiveExample("pages/js/array-push.html")}}

 
-
-
 
Syntaxe

 
 
arr.push(élément1, ..., élémentN)

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
 
 
{{EmbedInteractiveExample("pages/js/array-reduce.html")}}

 
-
-
 
Syntaxe

 
 
arr.reduce(callback)
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
 
 
{{EmbedInteractiveExample("pages/js/array-reduce-right.html")}}

 
-
+
 
 
Voir également {{jsxref("Array.prototype.reduce()")}} pour une méthode qui réduit de gauche à droite.

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-reverse.html")}}

 
-
-
 
Syntaxe

 
 
arr.reverse()

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
 
 
{{EmbedInteractiveExample("pages/js/array-shift.html")}}

 
-
-
 
Syntaxe

 
 
arr.shift()

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
 
 
{{EmbedInteractiveExample("pages/js/array-slice.html")}}

 
-
-
 
Syntaxe

 
 
arr.slice()
@@ -29,18 +27,11 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/slice
 
 

  
début {{optional_inline}}

- 
Indice (à partir de zéro) depuis lequel commencer l'extraction.

- 
S'il s'agit d'un indice négatif, début indique un décalage depuis la fin de la séquence. Par exemple, slice(-2) extrait les avant-dernier et dernier éléments dans la séquence.

+ 
Indice (à partir de zéro) depuis lequel commencer l'extraction. S'il s'agit d'un indice négatif, début indique un décalage depuis la fin de la séquence. Par exemple, slice(-2) extrait les avant-dernier et dernier éléments dans la séquence.

  

  Si début est absent, slice() commencera depuis 0. Si début est supérieur à la taille du tableau, c'est un tableau vide qui sera renvoyé.

-

-
-

  
fin {{optional_inline}}

- 
Indice (à partir de zéro) auquel arrêter l'extraction. slice() extrait jusqu'à cet indice, mais pas l'élément situé en fin lui-même.

- 
slice(1,4) 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, fin indique un décalage depuis la fin de la séquence. slice(2,-1) extrait du troisième à l'avant-dernier élément dans la séquence.

- 
Si fin n'est pas fourni, slice() extraira jusqu'à la fin de la séquence (arr.length). Si fin est supérieur à la longueur de la séquence, slice() fera une extraction jusqu'à la fin de la séquence.

+ 
Indice (à partir de zéro) auquel arrêter l'extraction. slice() extrait jusqu'à cet indice, mais pas l'élément situé en fin lui-même. slice(1,4) 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, fin indique un décalage depuis la fin de la séquence. slice(2,-1) extrait du troisième à l'avant-dernier élément dans la séquence. Si fin n'est pas fourni, slice() extraira jusqu'à la fin de la séquence (arr.length). Si fin est supérieur à la longueur de la séquence, slice() fera une extraction jusqu'à la fin de la séquence.

 

 
 
Valeur de retour

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
 
 
{{EmbedInteractiveExample("pages/js/array-some.html")}}

 
-
-
 
Syntaxe

 
 
arr.some(callback[, objetThis])

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
 
 
{{EmbedInteractiveExample("pages/js/array-sort.html")}}

 
-
-
 
Syntaxe

 
 
arr.sort()
@@ -40,7 +38,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/sort
 
 
Si le paramètre fonctionComparaison n'est pas fourni, les éléments qui ne valent pas undefined 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 undefined sont placés à la fin du tableau.

 
-

+

 
Note : En UTF-16, les caractères Unicode situés après \uFFFF sont encodés avec deux unités de code surrogates sur l'intervalle \uD800-\uDFFF. 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 surrogate \uD655 \uDE55 sera trié avant le caractère \uFF3A.

 

 
@@ -234,8 +232,8 @@ var result = mapped.map(function(e){
 });
 

 
-

-
Note : Une bibliothèque open source utilise cette approche : mapsort.

+

+
Note : Une bibliothèque open source utilise cette approche : mapsort.

 

 
 
Spécifications

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
 
 
{{EmbedInteractiveExample("pages/js/array-splice.html")}}

 
-
-
 
Syntaxe

 
 
var tabElementsSupprimes = array.splice(début, nbASupprimer[, élem1[, élem2[, ...]]])
@@ -27,19 +25,10 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/splice
 
 

  
début

- 
L'indice à partir duquel commencer à changer le tableau (l'indice du premier élement étant 0).

- 
Si sa valeur est supérieure à la longueur du tableau array.length, début est ramené à la longueur du tableau array.length.

- 
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  array.length + début. Si array.length + début est inférieur à 0, le changement commencera à l'index 0.

-

-
-

+ 
L'indice à partir duquel commencer à changer le tableau (l'indice du premier élement étant 0). Si sa valeur est supérieure à la longueur du tableau array.length, début est ramené à la longueur du tableau array.length. 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  array.length + début. Si array.length + début est inférieur à 0, le changement commencera à l'index 0.

  
nbASupprimer

  
Un entier indiquant le nombre d'anciens éléments à remplacer.

- Si ce paramètre est absent ou si sa valeur est supérieure ou égale à array.length - début, alors les éléments entre début et la fin du tableau seront supprimés.

- 
Si nbASupprimer vaut 0, aucun élément ne sera supprimé. Dans ce cas, il est nécessaire de spécifier au moins un nouvel élément.

-

-
-

+ Si ce paramètre est absent ou si sa valeur est supérieure ou égale à array.length - début, alors les éléments entre début et la fin du tableau seront supprimés. Si nbASupprimer vaut 0, aucun élément ne sera supprimé. Dans ce cas, il est nécessaire de spécifier au moins un nouvel élément.

  
élemN

  
Les éléments à ajouter au tableau à partir de début. Si vous ne spécifiez pas de nouvel élément, les anciens éléments seront simplement supprimés du tableau.

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-tolocalestring.html")}}

 
-
-
 
Syntaxe

 
 
arr.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
 
 
{{EmbedInteractiveExample("pages/js/array-tostring.html")}}

 
-
-
 
Syntaxe

 
 
arr.toString()

@@ -34,7 +32,7 @@ original_slug: Web/JavaScript/Reference/Objets_globaux/Array/toString
 
 
Sémantique d'ECMAScript 5

 
-
À partir de JavaScript 1.8.5 (Firefox 4), et en cohérence avec la 5e édition d'ECMAScript, la méthode toString() 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.

+
À partir de JavaScript 1.8.5 (Firefox 4), et en cohérence avec la 5e édition d'ECMAScript, la méthode toString() 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.

 
 
Spécifications

 
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
 
 
{{EmbedInteractiveExample("pages/js/array-unshift.html")}}

 
-
-
 
Syntaxe

 
 
arr.unshift([élém1[, ...[, élémN]]])

-- 
cgit v1.2.3-54-g00ecf