From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../global_objects/map/@@iterator/index.md | 81 ++++---- .../global_objects/map/@@species/index.md | 78 ++++---- .../global_objects/map/@@tostringtag/index.md | 47 ++--- .../reference/global_objects/map/clear/index.md | 70 +++---- .../reference/global_objects/map/delete/index.md | 76 +++----- .../reference/global_objects/map/entries/index.md | 74 +++----- .../reference/global_objects/map/foreach/index.md | 104 +++++------ .../reference/global_objects/map/get/index.md | 80 ++++---- .../reference/global_objects/map/has/index.md | 80 ++++---- .../reference/global_objects/map/index.md | 204 ++++++++++----------- .../reference/global_objects/map/keys/index.md | 72 +++----- .../reference/global_objects/map/set/index.md | 96 ++++------ .../reference/global_objects/map/size/index.md | 54 ++---- .../reference/global_objects/map/values/index.md | 73 +++----- 14 files changed, 479 insertions(+), 710 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/map') diff --git a/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.md b/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.md index 72bc8d1d13..a971dab13c 100644 --- a/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.md @@ -12,25 +12,26 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator --- -
{{JSRef}}
+{{JSRef}} -

La valeur initiale de la propriété @@iterator est la même fonction que la valeur initiale de la propriété {{jsxref("Map.prototype.entries()", "entries")}}.

+La valeur initiale de la propriété **`@@iterator`** est la même fonction que la valeur initiale de la propriété {{jsxref("Map.prototype.entries()", "entries")}}. -
{{EmbedInteractiveExample("pages/js/map-prototype-@@iterator.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-@@iterator.html")}} -

Syntaxe

+## Syntaxe -
maMap[Symbol.iterator]
+ maMap[Symbol.iterator] -

Valeur de retour

+### Valeur de retour -

La fonction d'itération (le symbole @@iterator) de l'objet, par défaut, c'est la fonction {{jsxref("Map.prototype.entries()","entries()")}}.

+La fonction d'itération (le symbole `@@iterator`) de l'objet, par défaut, c'est la fonction {{jsxref("Map.prototype.entries()","entries()")}}. -

Exemples

+## Exemples -

Utiliser [@@iterator]()

+### Utiliser `[@@iterator]()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("0", "toto");
 maMap.set(1, "truc");
 maMap.set({}, "bidule");
@@ -40,11 +41,12 @@ var mapIter = myMap[Symbol.iterator]();
 console.log(mapIter.next().value); // ["0", "toto"]
 console.log(mapIter.next().value); // [1, "truc"]
 console.log(mapIter.next().value); // [Object, "bidule"]
-
+``` -

Utiliser [@@iterator]() avec for..of

+### Utiliser `[@@iterator]()` avec `for..of` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("0", "toto");
 maMap.set(1, "truc");
 maMap.set({}, "bidule");
@@ -52,38 +54,21 @@ maMap.set({}, "bidule");
 for (var v of maMap) {
   console.log(v);
 }
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ES2015')}}Définition initiale
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.@@iterator")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}} | {{Spec2('ES2015')}} | Définition initiale | +| {{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.@@iterator")}} + +## Voir aussi + +- {{jsxref("Map.prototype.entries()")}} +- {{jsxref("Map.prototype.keys()")}} +- {{jsxref("Map.prototype.values()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/@@species/index.md b/files/fr/web/javascript/reference/global_objects/map/@@species/index.md index dddc3795f8..69c46bb86c 100644 --- a/files/fr/web/javascript/reference/global_objects/map/@@species/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/@@species/index.md @@ -10,62 +10,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species --- -
{{JSRef}}
+{{JSRef}} -

Map[@@species] renvoie le constructeur Map.

+**`Map[@@species]`** renvoie le constructeur `Map`. -

Syntaxe

+## Syntaxe -
Map[Symbol.species]
-
+ Map[Symbol.species] -

Description

+## Description -

L'accesseur species renvoie le constructeur par défaut pour les objets Map. Les constructeurs des sous-classes peuvent surcharger ce constructeur afin de modifier ce qui est fait lors de la construction de l'objet et son affectation

+L'accesseur `species` renvoie le constructeur par défaut pour les objets `Map`. Les constructeurs des sous-classes peuvent surcharger ce constructeur afin de modifier ce qui est fait lors de la construction de l'objet et son affectation -

Exemples

+## Exemples -

La propriété species renvoie la fonction correspondant au constructeur par défaut. Pour les objets Map, ce sera le constructeur Map :

+La propriété `species` renvoie la fonction correspondant au constructeur par défaut. Pour les objets `Map`, ce sera le constructeur `Map` : -
Map[Symbol.species]; // function Map()
+```js +Map[Symbol.species]; // function Map() +``` -

Pour des objets dérivés (par exemple un dictionnaire MaMap que vous auriez construit), la propriété species correspondra au constructeur MaMap. Si vous souhaitez surcharger cela pour renvoyer le constructeur parent Map, vous pourrez utiliser :

+Pour des objets dérivés (par exemple un dictionnaire `MaMap` que vous auriez construit), la propriété `species` correspondra au constructeur `MaMap`. Si vous souhaitez surcharger cela pour renvoyer le constructeur parent `Map`, vous pourrez utiliser : -
class MaMap extends Map {
+```js
+class MaMap extends Map {
   // On surcharge le symbole species de MaMap
   // avec le constructeur Map parent
   static get [Symbol.species]() { return Map; }
-}
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaires
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.@@species")}}

- -

Voir aussi

- - +} +``` + +## Spécifications + +| Spécification | Statut | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.@@species")}} + +## Voir aussi + +- {{jsxref("Map")}} +- {{jsxref("Symbol.species")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.md b/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.md index 251a4c46eb..0618585f04 100644 --- a/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.md @@ -11,44 +11,29 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag --- -
{{JSRef}}
+{{JSRef}} -

La propriété Map[@@toStringTag] vaut "Map" initialement.

+La propriété **`Map[@@toStringTag]`** vaut "Map" initialement. -
{{EmbedInteractiveExample("pages/js/map-prototype-@@tostringtag.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-@@tostringtag.html")}}{{js_property_attributes(0,0,1)}} -
{{js_property_attributes(0,0,1)}}
+## Syntaxe -

Syntaxe

+ Map[Symbol.toStringTag] -
Map[Symbol.toStringTag]
+## Exemple -

Exemple

+```js +Object.prototype.toString.call(new Map()) // "[object Map]" +``` -
Object.prototype.toString.call(new Map()) // "[object Map]"
+## Spécifications -

Spécifications

+| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}} | {{Spec2('ESDraft')}} |   | - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
+## Compatibilité des navigateurs -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.@@toStringTag")}}

+{{Compat("javascript.builtins.Map.@@toStringTag")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/clear/index.md b/files/fr/web/javascript/reference/global_objects/map/clear/index.md index 5c0dbc8661..7eb0c53805 100644 --- a/files/fr/web/javascript/reference/global_objects/map/clear/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/clear/index.md @@ -11,25 +11,26 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear --- -
{{JSRef}}
+{{JSRef}} -

La méthode clear() supprime tous les éléments d'un objet Map.

+La méthode **`clear()`** supprime tous les éléments d'un objet `Map`. -
{{EmbedInteractiveExample("pages/js/map-prototype-clear.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-clear.html")}} -

Syntaxe

+## Syntaxe -
maMap.clear();
+ maMap.clear(); -

Valeur de retour

+### Valeur de retour -

{{jsxref("undefined")}}.

+{{jsxref("undefined")}}. -

Exemple

+## Exemple -

Utiliser la méthode clear()

+### Utiliser la méthode `clear()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("truc", "bidule");
 maMap.set(1, "toto");
 
@@ -40,36 +41,19 @@ maMap.clear();
 
 maMap.size;        // 0
 maMap.has("truc")  // false
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.clear")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.clear")}} + +## Voir aussi + +- {{jsxref("Map")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/delete/index.md b/files/fr/web/javascript/reference/global_objects/map/delete/index.md index 3705d6bacc..0e8aa9ecf5 100644 --- a/files/fr/web/javascript/reference/global_objects/map/delete/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/delete/index.md @@ -11,64 +11,46 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete --- -
{{JSRef}}
+{{JSRef}} -

La méthode delete() permet de retirer un élément donné d'un objet Map grâce à sa clé.

+La méthode **`delete()`** permet de retirer un élément donné d'un objet `Map` grâce à sa clé. -
{{EmbedInteractiveExample("pages/js/map-prototype-delete.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-delete.html")}} -

Syntaxe

+## Syntaxe -
maMap.delete(clé);
+ maMap.delete(clé); -

Paramètres

+### Paramètres -
-
clé
-
Ce paramètre obligatoire correspond à la clé de l'élément qu'on souhaite retirer de l'objet Map.
-
+- `clé` + - : Ce paramètre obligatoire correspond à la clé de l'élément qu'on souhaite retirer de l'objet `Map`. -

Valeur de retour

+### Valeur de retour -

Un booléen. La méthode renvoie true si un élément de l'objet Map a bien été retiré ou false si l'élément n'existe pas.

+Un booléen. La méthode renvoie `true` si un élément de l'objet `Map` a bien été retiré ou `false` si l'élément n'existe pas. -

Exemples

+## Exemples -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("truc", "toto");
 
 maMap.delete("truc"); // Renvoie true. La suppression est OK.
 maMap.has("truc");    // Renvoie false. "truc" n'est plus présent.
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.delete")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.delete")}} + +## Voir aussi + +- {{jsxref("Map")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/entries/index.md b/files/fr/web/javascript/reference/global_objects/map/entries/index.md index 3deaed0bd3..a03e8f96c4 100644 --- a/files/fr/web/javascript/reference/global_objects/map/entries/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/entries/index.md @@ -12,25 +12,26 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries --- -
{{JSRef}}
+{{JSRef}} -

La méthode entries() renvoie un objet Iterator qui contient les paires [clé, valeur] pour chaque élément de l'objet Map, dans leur ordre d'insertion.

+La méthode **`entries()`** renvoie un objet [`Iterator`](/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs#Itérateurs) qui contient les paires `[clé, valeur]` pour chaque élément de l'objet `Map`, dans leur ordre d'insertion. -
{{EmbedInteractiveExample("pages/js/map-prototype-entries.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-entries.html")}} -

Syntaxe

+## Syntaxe -
maMap.entries()
+ maMap.entries() -

Valeur de retour

+### Valeur de retour -

Un nouvel objet Iterator {{jsxref("Map")}}.

+Un nouvel objet `Iterator` {{jsxref("Map")}}. -

Exemple

+## Exemple -

Utiliser entries()

+### Utiliser `entries()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("0", "toto");
 maMap.set(1, "truc");
 maMap.set({}, "bidule");
@@ -40,39 +41,20 @@ var mapIter = maMap.entries();
 console.log(mapIter.next().value); // ["0", "toto"]
 console.log(mapIter.next().value); // [1, "truc"]
 console.log(mapIter.next().value); // [Object, "bidule"]
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Défintion initiale.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.entries")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | ------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}} | {{Spec2('ES2015')}} | Défintion initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.entries")}} + +## Voir aussi + +- {{jsxref("Map.prototype.keys()")}} +- {{jsxref("Map.prototype.values()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/foreach/index.md b/files/fr/web/javascript/reference/global_objects/map/foreach/index.md index 4d2fbfdd70..da31bd273a 100644 --- a/files/fr/web/javascript/reference/global_objects/map/foreach/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/foreach/index.md @@ -11,52 +11,49 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach --- -
{{JSRef}}
+{{JSRef}} -

La méthode forEach() exécute une fonction donnée sur chaque élément clé-valeur de l'objet Map dans l'ordre d'insertion.

+La méthode **`forEach()`** exécute une fonction donnée sur chaque élément clé-valeur de l'objet `Map` dans l'ordre d'insertion. -
{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}} -

Syntaxe

+## Syntaxe -
maMap.forEach(callback[, thisArg])
+ maMap.forEach(callback[, thisArg]) -

Paramètres

+### Paramètres -
-
callback
-
La fonction à exécuter pour chaque élément.
-
thisArg
-
La valeur à utiliser comme contexte this lors de l'exécution de callback.
-
+- `callback` + - : La fonction à exécuter pour chaque élément. +- `thisArg` + - : La valeur à utiliser comme contexte `this` lors de l'exécution de `callback`. -

Valeur de retour

+### Valeur de retour -

{{jsxref("undefined")}}

+{{jsxref("undefined")}} -

Description

+## Description -

La méthode forEach exécute la fonction callback donnée sur chacune des clés qui existe. Elle n'est pas appelée pour les clés qui ont été supprimées. En revanche, elle est appelée pour les valeurs qui sont présentes mais qui sont égales à undefined.

+La méthode `forEach` exécute la fonction `callback` donnée sur chacune des clés qui existe. Elle n'est pas appelée pour les clés qui ont été supprimées. En revanche, elle est appelée pour les valeurs qui sont présentes mais qui sont égales à `undefined`. -

callback est appelé avec trois arguments :

+`callback` est appelé avec **trois arguments** : - +- la **valeur de l'élément** +- la **clé de l'élément** +- l'objet **`Map` parcouru** -

Si un argument thisArg est fourni à la méthode forEach, il sera passé au callback quand il sera appelé et celui-ci l'utilisera comme valeur this. Dans les autres cas, la valeur undefined sera utilisée comme contexte this. La valeur this observée par la fonction callback est déterminée selon les règles appliquées à l'opérateur this.

+Si un argument `thisArg` est fourni à la méthode `forEach`, il sera passé au `callback` quand il sera appelé et celui-ci l'utilisera comme valeur `this`. Dans les autres cas, la valeur `undefined` sera utilisée comme contexte `this`. La valeur `this` observée par la fonction `callback` est déterminée selon [les règles appliquées à l'opérateur `this`](/fr/docs/JavaScript/Reference/Opérateurs/Opérateurs_spéciaux/L'opérateur_this). -

Chacune des valeurs sera traitée une fois sauf si celle-ci a été supprimée puis réajoutée avant la fin de forEach. callback n'est pas appelé pour les valeurs qui sont supprimés avant le passage de la fonction. Les valeurs qui sont ajoutées avant que forEach ait parcouru l'ensemble seront traitées.

+Chacune des valeurs sera traitée une fois sauf si celle-ci a été supprimée puis réajoutée avant la fin de `forEach`. `callback` n'est pas appelé pour les valeurs qui sont supprimés avant le passage de la fonction. Les valeurs qui sont ajoutées avant que `forEach` ait parcouru l'ensemble seront traitées. -

forEach exécute la fonction callback une fois pour chaque élément de l'objet Map : il ne renvoie pas de valeur.

+`forEach` exécute la fonction `callback` une fois pour chaque élément de l'objet `Map` : il ne renvoie pas de valeur. -

Exemples

+## Exemples -

Le fragment de code suivant enregistre une ligne pour chaque élément d'un objet Map :

+Le fragment de code suivant enregistre une ligne pour chaque élément d'un objet` Map `: -
function logMapElements(valeur, clé, map) {
+```js
+function logMapElements(valeur, clé, map) {
     console.log(`map.get('${clé}') = ${value}`);
 }
 
@@ -66,37 +63,20 @@ new Map([["toto", 3], ["truc", {}], ["bidule", undefined]]).forEach(logMapElemen
 // "map.get('toto') = 3"
 // "map.get('truc') = [object Object]"
 // "map.get('bidule') = undefined"
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.forEach")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.forEach")}} + +## Voir aussi + +- {{jsxref("Array.prototype.forEach()")}} +- {{jsxref("Set.prototype.forEach()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/get/index.md b/files/fr/web/javascript/reference/global_objects/map/get/index.md index bf2e8cba01..5dbc57ae3a 100644 --- a/files/fr/web/javascript/reference/global_objects/map/get/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/get/index.md @@ -11,66 +11,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/get original_slug: Web/JavaScript/Reference/Global_Objects/Map/get --- -
{{JSRef}}
+{{JSRef}} -

La méthode get() renvoie un élément précisé d'un objet Map. Si la valeur associée à la clé fournie est un objet, alors on obtient une référence à cet objet et tous changements apporté à cet objet sera aussi visible à l'intérieur de l'objet Map.

+La méthode **`get()`** renvoie un élément précisé d'un objet `Map`. Si la valeur associée à la clé fournie est un objet, alors on obtient une référence à cet objet et tous changements apporté à cet objet sera aussi visible à l'intérieur de l'objet `Map`. -
{{EmbedInteractiveExample("pages/js/map-prototype-get.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-get.html")}} -

Syntaxe

+## Syntaxe -
maMap.get(clé)
+ maMap.get(clé) -

Paramètres

+### Paramètres -
-
clé
-
La clé de l'élément à renvoyer depuis l'objet Map.
-
+- `clé` + - : La clé de l'élément à renvoyer depuis l'objet `Map`. -

Valeur de retour

+### Valeur de retour -

L'élément associée à la clé donnée ou {{jsxref("undefined")}} si la clé ne fait pas partie de l'objet Map.

+L'élément associée à la clé donnée ou {{jsxref("undefined")}} si la clé ne fait pas partie de l'objet `Map`. -

Exemples

+## Exemples -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("truc", "toto");
 
 maMap.get("truc");     // Renvoie "toto".
 maMap.get("machin");   // Renvoie undefined.
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.get")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.get")}} + +## Voir aussi + +- {{jsxref("Map")}} +- {{jsxref("Map.prototype.set()")}} +- {{jsxref("Map.prototype.has()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/has/index.md b/files/fr/web/javascript/reference/global_objects/map/has/index.md index ce26d66e47..998b7fe3bc 100644 --- a/files/fr/web/javascript/reference/global_objects/map/has/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/has/index.md @@ -11,66 +11,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/has original_slug: Web/JavaScript/Reference/Global_Objects/Map/has --- -
{{JSRef}}
+{{JSRef}} -

La méthode has() renvoie un booléen permettant de déterminer si l'objet Map en question contient la clé donnée.

+La méthode **`has()`** renvoie un booléen permettant de déterminer si l'objet `Map` en question contient la clé donnée. -
{{EmbedInteractiveExample("pages/js/map-prototype-has.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-has.html")}} -

Syntaxe

+## Syntaxe -
maMap.has(clé);
+ maMap.has(clé); -

Paramètres

+### Paramètres -
-
clé
-
Ce paramètre obligatoire correspond à la clé dont on veut savoir si elle appartient à l'objet Map.
-
+- `clé` + - : Ce paramètre obligatoire correspond à la clé dont on veut savoir si elle appartient à l'objet `Map`. -

Valeur de retour

+### Valeur de retour -

Cette méthode renvoie un booléen : true si un élément avec cette clé existe au sein de l'objet Map et false sinon.

+Cette méthode renvoie un booléen : `true` si un élément avec cette clé existe au sein de l'objet `Map` et `false` sinon. -

Exemples

+## Exemples -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("truc", "toto");
 
 maMap.has("truc");  // renvoie true
 maMap.has("machin");// renvoie false
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.has")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.has")}} + +## Voir aussi + +- {{jsxref("Map")}} +- {{jsxref("Map.prototype.set()")}} +- {{jsxref("Map.prototype.get()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/index.md b/files/fr/web/javascript/reference/global_objects/map/index.md index 7e49822844..81d5b8cb36 100644 --- a/files/fr/web/javascript/reference/global_objects/map/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/index.md @@ -9,82 +9,75 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map original_slug: Web/JavaScript/Reference/Global_Objects/Map --- -
{{JSRef}}
+{{JSRef}} -

L'objet Map représente un dictionnaire, autrement dit une carte de clés/valeurs. N'importe quelle valeur valable en JavaScript (que ce soit les objets ou les valeurs de types primitifs) peut être utilisée comme clé ou comme valeur.

+L'objet **`Map`** représente un dictionnaire, autrement dit une carte de clés/valeurs. N'importe quelle valeur valable en JavaScript (que ce soit les objets ou les valeurs de types primitifs) peut être utilisée comme clé ou comme valeur. -

L'ordre d'insertion des clés est mémorisé dans l'objet et les boucles sur les Map parcourent les clés dans cet ordre.

+L'ordre d'insertion des clés est mémorisé dans l'objet et les boucles sur les `Map` parcourent les clés dans cet ordre. -

Syntaxe

+## Syntaxe -
new Map([iterable])
+ new Map([iterable]) -

Paramètres

+### Paramètres -
-
itérable
-
Un tableau ({{jsxref("Array")}}) ou tout autre objet itérable dont les éléments sont des paires clé/valeur (par exemple un tableau de la forme [[1 , "toto"],[2, "truc"]]). Chaque paire clé/valeur sera ajoutée au nouvel objet Map. {{jsxref("null")}} est traité comme {{jsxref("undefined")}}.
-
+- `itérable` + - : Un tableau ({{jsxref("Array")}}) ou tout autre objet [itérable](/fr/docs/Web/JavaScript/Reference/Les_protocoles_iteration#Le_protocole_«_itérable_») dont les éléments sont des paires clé/valeur (par exemple un tableau de la forme `[[1 , "toto"],[2, "truc"]]`). Chaque paire clé/valeur sera ajoutée au nouvel objet `Map`. {{jsxref("null")}} est traité comme {{jsxref("undefined")}}. -

Description

+## Description -

Un objet Map permet de retrouver ses éléments dans leur ordre d'insertion. Par exemple, une boucle {{jsxref("Instructions/for...of","for...of")}} renverra un tableau de [clé, valeur] pour chaque itération.

+Un objet `Map` permet de retrouver ses éléments dans leur ordre d'insertion. Par exemple, une boucle {{jsxref("Instructions/for...of","for...of")}} renverra un tableau de `[clé, valeur]` pour chaque itération. -

On notera qu'un objet Map contenant des objets ne sera parcouru que dans l'ordre d'insertion de ces objets. Avec ES2015, l'ordre d'itération est fixé pour les objets. Toutefois, pour les versions antérieures d'ECMAScript, cet ordre n'est pas garanti.

+On notera qu'un objet `Map` contenant des objets ne sera parcouru que dans l'ordre d'insertion de ces objets. Avec ES2015, l'ordre d'itération est fixé pour les objets. Toutefois, pour les versions antérieures d'ECMAScript, cet ordre n'est pas garanti. -

Égalité des clés

+### Égalité des clés -

L'égalité des clés est testée avec l'algorithme basé sur l'égalité de valeurs :

+L'égalité des clés est testée avec l'algorithme basé sur [l'égalité de valeurs](/fr/docs/JavaScript/Les_différents_tests_d_Égalité_comment_les_utiliser#.C3.89galit.C3.A9_de_valeurs) : - +- {{jsxref("NaN")}} est considéré égal à `NaN` (bien que, pour l'égalité stricte `NaN !== NaN`) +- les autres valeurs sont considérées égales au sens de l'égalité stricte (l'opérateur  `===`). -

Dans les versions précédentes des brouillons ECMAScript 2015 (ES6) -0 et +0 étaient considérés différents (bien que -0 === +0), ceci a été changé dans les versions ultérieures et a été adapté avec Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) et une version nocturne de Chrome.

+Dans les versions précédentes des brouillons ECMAScript 2015 (ES6) `-0` et `+0` étaient considérés différents (bien que `-0 === +0`), ceci a été changé dans les versions ultérieures et a été adapté avec Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) et une version nocturne de [Chrome](https://code.google.com/p/v8/issues/detail?id=3069). -

Comparaison entre objets et maps

+### Comparaison entre objets et maps -

Les {{jsxref("Object", "objets","",1)}} sont similaires aux Maps, chacun manipulant des clés associées à des valeurs, récupérant ces valeurs, supprimant des clés... Il n'y avait auparavant pas d'alternatives natives et c'est pourquoi, historiquement, les objets JavaScript ont été utilisés comme des Maps. Malgré tout, il y a des différences importantes entre Objects et Maps qui permettent de distinguer une utilisation des objets Map plus efficace :

+Les {{jsxref("Object", "objets","",1)}} sont similaires aux `Maps`, chacun manipulant des clés associées à des valeurs, récupérant ces valeurs, supprimant des clés... Il n'y avait auparavant pas d'alternatives natives et c'est pourquoi, historiquement, les objets JavaScript ont été utilisés comme des `Maps`. Malgré tout, il y a des différences importantes entre` Objects` et `Maps` qui permettent de distinguer une utilisation des objets `Map` plus efficace : - +- Un `Object` possède un prototype, certaines clés par défaut peuvent donc entrer en collision avec les clés qu'on souhaite créer. À partir d'ES5, on peut écrire `map = `{{jsxref("Object.create", "Object.create(null)")}} mais cette formulation est rarement utilisée. +- Les clés d'une `Map` sont ordonnées tandis que les clés d'un objet n'ont pas d'ordre particulier. Ainsi, quand on parcourt une `Map`, on obtient les clés selon leur ordre d'insertion. On notera qu'à partir d'ECMAScript 2015, la spécification pour les objets indique de conserver l'ordre de création pour les clés qui sont des chaînes et des symboles. +- Les clés d'un `Object` sont des {{jsxref("String", "chaînes de caractères","",1)}} ou des symboles (cf. {{jsxref("Symbol")}}), alors que pour une `Map` ça peut être n'importe quelle valeur. +- Il est possible d'obtenir facilement la taille d'une `Map` avec `size`. En revanche, pour un `Object` il faudra compter « manuellement ». +- Un objet `Map` est un [itérable](/fr/docs/Web/JavaScript/Reference/Les_protocoles_iteration#Le_protocole_«_itérable_») et on peut donc le parcourir directement. En revanche, itérer sur un `Object` nécessite de récupérer les clés de l'objet pour ensuite les parcourir. +- Un objet `Map` permettra d'obtenir de meilleures performances si on ajoute et supprime des éléments fréquemment. -

Propriétés

+## Propriétés -
-
Map.length
-
La valeur de la propriété length est 0.
- Attention, pour compter le nombre d'élément contenu dans une Map, on utilisera plutôt {{jsxref("Map.prototype.size")}}.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
La fonction constructeur utilisée pour créer des objets dérivées.
-
{{jsxref("Map.prototype")}}
-
Représente le prototype du constructeur Map. Permet l'addition de propriétés à tous les objets Map.
-
+- `Map.length` + - : La valeur de la propriété `length` est 0. + Attention, pour compter le nombre d'élément contenu dans une `Map`, on utilisera plutôt {{jsxref("Map.prototype.size")}}. +- {{jsxref("Map.@@species", "get Map[@@species]")}} + - : La fonction constructeur utilisée pour créer des objets dérivées. +- {{jsxref("Map.prototype")}} + - : Représente le prototype du constructeur `Map`. Permet l'addition de propriétés à tous les objets `Map`. -

Instances de Map

+## Instances de `Map` -

Toutes les instances de Map héritent de {{jsxref("Map.prototype")}}.

+Toutes les instances de `Map` héritent de {{jsxref("Map.prototype")}}. -

Propriétés

+### Propriétés -

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/prototype','Propriétés')}}

+{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/prototype','Propriétés')}} -

Méthodes

+### Méthodes -

{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/prototype','Méthodes')}}

+{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/prototype','Méthodes')}} -

Exemples

+## Exemples -

Utiliser un objet Map

+### Utiliser un objet `Map` -
const myMap = new Map();
+```js
+const myMap = new Map();
 
 const objectKey = {},
     functionKey = function () {},
@@ -106,26 +99,28 @@ myMap.get("une chaîne");  // "valeur associée à 'une chaîne'"
                           // car chaineClé === 'une chaîne'
 myMap.get({});            // indéfini car objetClé !== {}
 myMap.get(function() {}); // indéfini car fonctionClé !== function () {}
-
+``` -

Utiliser NaN comme clé

+### Utiliser `NaN` comme clé -

{{jsxref("NaN")}} peut être utilisé comme une clé. Bien que NaN ne soit pas strictement égal à lui-même (NaN !== NaN est vérifié), on peut bâtir l'exemple suivant car on ne peut pas distinguer deux valeurs NaN :

+{{jsxref("NaN")}} peut être utilisé comme une clé. Bien que `NaN` ne soit pas strictement égal à lui-même (`NaN !== NaN` est vérifié), on peut bâtir l'exemple suivant car on ne peut pas distinguer deux valeurs `NaN `: -
const myMap = new Map();
+```js
+const myMap = new Map();
 myMap.set(NaN, "not a number");
 
 myMap.get(NaN); // "not a number"
 
 const otherNaN = Number("toto");
 myMap.get(otherNaN); // "not a number"
-
+``` -

Parcourir des objets Maps avec for..of

+### Parcourir des objets `Maps` avec `for..of` -

Il est possible de parcourir les objets Map grâce à des boucles for..of :

+Il est possible de parcourir les objets `Map `grâce à des boucles `for..of` : -
const myMap = new Map();
+```js
+const myMap = new Map();
 myMap.set(0, "zéro");
 myMap.set(1, "un");
 for (const [key, value] of myMap) {
@@ -157,11 +152,12 @@ myMap.forEach(function(value, key) {
 });
 // On aura 2 lignes : la première avec "0 = zéro"
 // la seconde avec "1 = un"
-
+``` -

Relation avec les objets Array

+### Relation avec les objets `Array` -
const keyValuePair = [["clé1", "valeur1"], ["clé2", "valeur2"]];
+```js
+const keyValuePair = [["clé1", "valeur1"], ["clé2", "valeur2"]];
 
 // On utilise le constructeur Map
 // pour transformer un tableau de clés/valeurs
@@ -176,26 +172,30 @@ console.log(Array.from(myMap)); // affichera la même chose que tableauCléValeu
 
 // On peut aussi l'utiliser pour n'extraire que les clés
 // ou les valeurs et créer le tableau associé
-console.log(Array.from(myMap.keys())); // affichera ["clé1", "clé2"]
+console.log(Array.from(myMap.keys())); // affichera ["clé1", "clé2"] +``` -

Cloner et fusionner des objets Map

+### Cloner et fusionner des objets `Map` -

Il est possible de cloner des Map comme on clone des tableaux :

+Il est possible de cloner des `Map` comme on clone des tableaux : -
const original = new Map([
+```js
+const original = new Map([
   [1, 'un']
 ]);
 
 const clone = new Map(original);
 
 console.log(clone.get(1)); // un
-console.log(original === clone); // false. Utile pour une comparaison superficielle
+console.log(original === clone); // false. Utile pour une comparaison superficielle +``` -

Attention, la donnée contenue dans la Map n'est pas clonée.

+Attention, la donnée contenue dans la `Map` n'est pas clonée. -

Il est également possible de fusionner deux Map en conservant le critère d'unicité sur les clés :

+Il est également possible de fusionner deux `Map` en conservant le critère d'unicité sur les clés : -
const first = new Map([
+```js
+const first = new Map([
   [1, 'un'],
   [2, 'deux'],
   [3, 'trois'],
@@ -214,11 +214,13 @@ const fusion = new Map([...first, ...second]);
 
 console.log(fusion.get(1)); // uno
 console.log(fusion.get(2)); // dos
-console.log(fusion.get(3)); // trois
+console.log(fusion.get(3)); // trois +``` -

Il est également possible de fusionner des objets Map avec des objets Array :

+Il est également possible de fusionner des objets `Map` avec des objets `Array` : -
const first = new Map([
+```js
+const first = new Map([
   [1, 'un'],
   [2, 'deux'],
   [3, 'trois'],
@@ -235,42 +237,24 @@ const fusion = new Map([...first, ...second, [1, 'eins']]);
 
 console.log(fusion.get(1)); // eins
 console.log(fusion.get(2)); // dos
-console.log(fusion.get(3)); // trois
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map")}}

- -

Voir aussi

- - +console.log(fusion.get(3)); // trois +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map-objects', 'Map')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map-objects', 'Map')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map")}} + +## Voir aussi + +- [Le bug sur Map et Set pour Mozilla](https://bugzilla.mozilla.org/show_bug.cgi?id=697479) +- [La proposition ECMAScript Harmony](https://web.archive.org/web/20170105121945/http://wiki.ecmascript.org:80/doku.php?id=harmony:simple_maps_and_sets) +- {{jsxref("Set")}} +- {{jsxref("WeakMap")}} +- {{jsxref("WeakSet")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/keys/index.md b/files/fr/web/javascript/reference/global_objects/map/keys/index.md index 423cf8d7dd..94943f763b 100644 --- a/files/fr/web/javascript/reference/global_objects/map/keys/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/keys/index.md @@ -11,25 +11,26 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys --- -
{{JSRef}}
+{{JSRef}} -

La méthode keys() renvoie un objet Iterator qui contient les clés de chaque élément de l'objet Map, dans leur ordre d'insertion.

+La méthode **`keys()`** renvoie un objet [`Iterator`](/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs) qui contient les clés de chaque élément de l'objet `Map`, dans leur ordre d'insertion. -
{{EmbedInteractiveExample("pages/js/map-prototype-keys.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-keys.html")}} -

Syntaxe

+## Syntaxe -
maMap.keys()
+ maMap.keys() -

Valeur de retour

+### Valeur de retour -

Un nouvel objet Iterator {{jsxref("Map")}}.

+Un nouvel objet `Iterator` {{jsxref("Map")}}. -

Exemples

+## Exemples -

Utiliser keys()

+### Utiliser `keys()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("0", "toto");
 maMap.set(1, "truc");
 maMap.set({}, "bidule");
@@ -39,37 +40,20 @@ var mapIter = maMap.keys();
 console.log(mapIter.next().value); // "0"
 console.log(mapIter.next().value); // 1
 console.log(mapIter.next().value); // Object
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.keys")}}

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.keys")}} + +## Voir aussi + +- {{jsxref("Map.prototype.entries()")}} +- {{jsxref("Map.prototype.values()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/set/index.md b/files/fr/web/javascript/reference/global_objects/map/set/index.md index b0e695aed3..b25fc7c250 100644 --- a/files/fr/web/javascript/reference/global_objects/map/set/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/set/index.md @@ -11,34 +11,33 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/set original_slug: Web/JavaScript/Reference/Global_Objects/Map/set --- -
{{JSRef}}
+{{JSRef}} -

La méthode set() ajoute un nouvel élément avec une clé et une valeur données à un objet Map.

+La méthode **`set()`** ajoute un nouvel élément avec une `clé` et une `valeur` données à un objet `Map`. -
{{EmbedInteractiveExample("pages/js/map-prototype-set.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-set.html")}} -

Syntaxe

+## Syntaxe -
maMap.set(clé, valeur);
+ maMap.set(clé, valeur); -

Paramètres

+### Paramètres -
-
clé
-
Ce paramètre représente la clé de l'élément à ajouter à l'objet Map.
-
valeur
-
Ce paramètre représente la valeur de l'élément à ajouter à l'objet Map.
-
+- `clé` + - : Ce paramètre représente la clé de l'élément à ajouter à l'objet `Map`. +- `valeur` + - : Ce paramètre représente la valeur de l'élément à ajouter à l'objet `Map`. -

Valeur de retour

+### Valeur de retour -

L'objet Map courant (auquel l'élément a été ajouté).

+L'objet `Map` courant (auquel l'élément a été ajouté). -

Exemples

+## Exemples -

Utiliser la méthode set()

+### Utiliser la méthode `set()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 
 // On ajoute de nouveaux éléments à l'objet map
 maMap.set("truc", "toto");
@@ -46,48 +45,33 @@ maMap.set(1, "bidule");
 
 // On met à jour un élément
 maMap.set("truc", "fuuu");
-
+``` -

Utiliser la méthode set() avec un enchaînement

+### Utiliser la méthode `set()` avec un enchaînement -

La méthode set() renvoie le même objet Map et on peut donc la « chaîner » pour des opérations successives :

+La méthode `set()` renvoie le même objet `Map` et on peut donc la « chaîner » pour des opérations successives : -
// On ajoute de nouveaux éléments
+```js
+// On ajoute de nouveaux éléments
 // en enchaînant les appels à set()
 maMap.set('truc', 'toto')
      .set(1, 'tototruc')
-     .set(2, 'bidule');
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.set")}}

- -

Voir aussi

- - + .set(2, 'bidule'); +``` + +## Spécifications + +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.set")}} + +## Voir aussi + +- {{jsxref("Map")}} +- {{jsxref("Map.prototype.get()")}} +- {{jsxref("Map.prototype.has()")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/size/index.md b/files/fr/web/javascript/reference/global_objects/map/size/index.md index 0473610825..898542a176 100644 --- a/files/fr/web/javascript/reference/global_objects/map/size/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/size/index.md @@ -10,56 +10,40 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/size original_slug: Web/JavaScript/Reference/Global_Objects/Map/size --- -
{{JSRef}}
+{{JSRef}} -

L'accesseur size est une propriété renvoyant le nombre d'éléments d'un objet {{jsxref("Map")}}.

+L'accesseur **`size`** est une propriété renvoyant le nombre d'éléments d'un objet {{jsxref("Map")}}. -
{{EmbedInteractiveExample("pages/js/map-prototype-size.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-size.html")}} -

Description

+## Description -

La valeur de size est un entier représentant le nombre d'entrées d'un objet Map. Le mutateur correspond à cette propriété est {{jsxref("undefined")}}, on ne peut pas donc pas modifier cette propriété.

+La valeur de `size` est un entier représentant le nombre d'entrées d'un objet `Map`. Le mutateur correspond à cette propriété est {{jsxref("undefined")}}, on ne peut pas donc pas modifier cette propriété. -

Exemple

+## Exemple -

Utiliser size

+### Utiliser `size` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("a", "alpha");
 maMap.set("b", "beta");
 maMap.set("g", "gamma");
 
 maMap.size // 3
-
+``` -

Spécifications

+## Spécifications - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}} | {{Spec2('ESDraft')}} |   | -

Compatibliité des navigateurs

+## Compatibliité des navigateurs -

{{Compat("javascript.builtins.Map.size")}}

+{{Compat("javascript.builtins.Map.size")}} -

Voir aussi

+## Voir aussi - +- {{jsxref("Map")}} diff --git a/files/fr/web/javascript/reference/global_objects/map/values/index.md b/files/fr/web/javascript/reference/global_objects/map/values/index.md index 8071caa2d0..07c000c242 100644 --- a/files/fr/web/javascript/reference/global_objects/map/values/index.md +++ b/files/fr/web/javascript/reference/global_objects/map/values/index.md @@ -12,25 +12,26 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Map/values original_slug: Web/JavaScript/Reference/Global_Objects/Map/values --- -
{{JSRef}}
+{{JSRef}} -

La méthode values() renvoie un objet Iterator qui contient les valeurs de chacun des éléments contenu dans l'objet Map donné, dans leur ordre d'insertion.

+La méthode **`values()`** renvoie un objet [`Iterator`](/fr/docs/Web/JavaScript/Guide/iterateurs_et_generateurs) qui contient les valeurs de chacun des éléments contenu dans l'objet `Map` donné, dans leur ordre d'insertion. -
{{EmbedInteractiveExample("pages/js/map-prototype-values.html")}}
+{{EmbedInteractiveExample("pages/js/map-prototype-values.html")}} -

Syntaxe

+## Syntaxe -
maMap.values()
+ maMap.values() -

Valeur de retour

+### Valeur de retour -

Un nouvel objet Iterator {{jsxref("Map")}}.

+Un nouvel objet `Iterator` {{jsxref("Map")}}. -

Exemple

+## Exemple -

Utiliser values()

+### Utiliser `values()` -
var maMap = new Map();
+```js
+var maMap = new Map();
 maMap.set("0", "toto");
 maMap.set(1, "truc");
 maMap.set({}, "licorne");
@@ -39,37 +40,21 @@ var mapIter = maMap.values();
 
 console.log(mapIter.next().value); // "toto"
 console.log(mapIter.next().value); // "truc"
-console.log(mapIter.next().value); // "licorne"
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Définition initiale.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Map.values")}}

- -

Voir aussi

- - +console.log(mapIter.next().value); // "licorne" +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}} | {{Spec2('ES2015')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}} | {{Spec2('ESDraft')}} |   | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Map.values")}} + +## Voir aussi + +- {{jsxref("Map.prototype.entries()")}} +- {{jsxref("Map.prototype.keys()")}} -- cgit v1.2.3-54-g00ecf