From 4551c391bff4918e9eb4b5fa9edfa0b078b07b8d Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Fri, 23 Jul 2021 11:06:11 -0400 Subject: wasn't supposed to be orphaned (fr) (#1673) * wasn't supposed to be orphaned (fr) * fix redirects * fix slug front-matter --- files/fr/_redirects.txt | 39 --- .../global_objects/map/@@iterator/index.html | 91 ------- .../global_objects/map/@@species/index.html | 71 ------ .../global_objects/map/@@tostringtag/index.html | 56 ----- .../reference/global_objects/map/clear/index.html | 77 ------ .../reference/global_objects/map/delete/index.html | 76 ------ .../global_objects/map/entries/index.html | 80 ------ .../global_objects/map/foreach/index.html | 104 -------- .../reference/global_objects/map/get/index.html | 78 ------ .../reference/global_objects/map/has/index.html | 78 ------ .../reference/global_objects/map/index.html | 276 --------------------- .../reference/global_objects/map/keys/index.html | 77 ------ .../reference/global_objects/map/set/index.html | 95 ------- .../reference/global_objects/map/size/index.html | 67 ----- .../reference/global_objects/map/values/index.html | 77 ------ .../global_objects/map/@@iterator/index.html | 91 +++++++ .../global_objects/map/@@species/index.html | 71 ++++++ .../global_objects/map/@@tostringtag/index.html | 56 +++++ .../reference/global_objects/map/clear/index.html | 77 ++++++ .../reference/global_objects/map/delete/index.html | 76 ++++++ .../global_objects/map/entries/index.html | 80 ++++++ .../global_objects/map/foreach/index.html | 104 ++++++++ .../reference/global_objects/map/get/index.html | 78 ++++++ .../reference/global_objects/map/has/index.html | 78 ++++++ .../reference/global_objects/map/index.html | 276 +++++++++++++++++++++ .../reference/global_objects/map/keys/index.html | 77 ++++++ .../reference/global_objects/map/set/index.html | 95 +++++++ .../reference/global_objects/map/size/index.html | 67 +++++ .../reference/global_objects/map/values/index.html | 77 ++++++ 29 files changed, 1303 insertions(+), 1342 deletions(-) delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/map/values/index.html (limited to 'files') diff --git a/files/fr/_redirects.txt b/files/fr/_redirects.txt index 28e928c222..f172346bee 100644 --- a/files/fr/_redirects.txt +++ b/files/fr/_redirects.txt @@ -2353,18 +2353,7 @@ /fr/docs/JavaScript/Reference/Objets_globaux/JSON /fr/docs/Web/JavaScript/Reference/Global_Objects/JSON /fr/docs/JavaScript/Reference/Objets_globaux/JSON/parse /fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse /fr/docs/JavaScript/Reference/Objets_globaux/JSON/stringify /fr/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify -/fr/docs/JavaScript/Reference/Objets_globaux/Map /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/JavaScript/Reference/Objets_globaux/Map/clear /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -/fr/docs/JavaScript/Reference/Objets_globaux/Map/delete /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -/fr/docs/JavaScript/Reference/Objets_globaux/Map/entries /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -/fr/docs/JavaScript/Reference/Objets_globaux/Map/forEach /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -/fr/docs/JavaScript/Reference/Objets_globaux/Map/get /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -/fr/docs/JavaScript/Reference/Objets_globaux/Map/has /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -/fr/docs/JavaScript/Reference/Objets_globaux/Map/keys /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /fr/docs/JavaScript/Reference/Objets_globaux/Map/prototype /fr/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/JavaScript/Reference/Objets_globaux/Map/set /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -/fr/docs/JavaScript/Reference/Objets_globaux/Map/size /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -/fr/docs/JavaScript/Reference/Objets_globaux/Map/values /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /fr/docs/JavaScript/Reference/Objets_globaux/Math /fr/docs/Web/JavaScript/Reference/Global_Objects/Math /fr/docs/JavaScript/Reference/Objets_globaux/Math/E /fr/docs/Web/JavaScript/Reference/Global_Objects/Math/E /fr/docs/JavaScript/Reference/Objets_globaux/Math/LN10 /fr/docs/Web/JavaScript/Reference/Global_Objects/Math/LN10 @@ -4680,20 +4669,6 @@ /fr/docs/Web/JavaScript/Reference/Global_Objects/Collator /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator /fr/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/ListFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/get /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/has /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/set /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/size /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -/fr/docs/Web/JavaScript/Reference/Global_Objects/Map/values /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /fr/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/PluralRules /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules /fr/docs/Web/JavaScript/Reference/Global_Objects/RelativeTimeFormat /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/RelativeTimeFormat @@ -5036,21 +5011,7 @@ /fr/docs/Web/JavaScript/Reference/Objets_globaux/Locale/region /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/region /fr/docs/Web/JavaScript/Reference/Objets_globaux/Locale/script /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/script /fr/docs/Web/JavaScript/Reference/Objets_globaux/Locale/toString /fr/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/toString -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@iterator /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@species /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@toStringTag /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/clear /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/delete /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/entries /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/forEach /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/get /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/has /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/keys /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/prototype /fr/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/set /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/size /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/values /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /fr/docs/Web/JavaScript/Reference/Objets_globaux/Math /fr/docs/Web/JavaScript/Reference/Global_Objects/Math /fr/docs/Web/JavaScript/Reference/Objets_globaux/Math/E /fr/docs/Web/JavaScript/Reference/Global_Objects/Math/E /fr/docs/Web/JavaScript/Reference/Objets_globaux/Math/LN10 /fr/docs/Web/JavaScript/Reference/Global_Objects/Math/LN10 diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html deleted file mode 100644 index 5eb65fed52..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Map.prototype[@@iterator]() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator -original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator ---- -
{{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")}}.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-@@iterator.html")}}
- - - -

Syntaxe

- -
maMap[Symbol.iterator]
- -

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()")}}.

- -

Exemples

- -

Utiliser [@@iterator]()

- -
var maMap = new Map();
-maMap.set("0", "toto");
-maMap.set(1, "truc");
-maMap.set({}, "bidule");
-
-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

- -
var maMap = new Map();
-maMap.set("0", "toto");
-maMap.set(1, "truc");
-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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index e5311496a4..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: get Map[@@species] -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Propriété - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species -original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -
{{JSRef}}
- -

Map[@@species] renvoie le constructeur Map.

- -

Syntaxe

- -
Map[Symbol.species]
-
- -

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

- -

Exemples

- -

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()
- -

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 {
-  // 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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html deleted file mode 100644 index a1487397a3..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Map.prototype[@@toStringTag]() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag ---- -
{{JSRef}}
- -

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

- -
{{EmbedInteractiveExample("pages/js/map-prototype-@@tostringtag.html")}}
- - - -
{{js_property_attributes(0,0,1)}}
- -

Syntaxe

- -
Map[Symbol.toStringTag]
- -

Exemple

- -
Object.prototype.toString.call(new Map()) // "[object Map]"
- -

Spécifications

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

- -

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

diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index af316a5d35..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.clear() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear -original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

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

- -
{{EmbedInteractiveExample("pages/js/map-prototype-clear.html")}}
- - - -

Syntaxe

- -
maMap.clear();
- -

Valeur de retour

- -

{{jsxref("undefined")}}.

- -

Exemple

- -

Utiliser la méthode clear()

- -
var maMap = new Map();
-maMap.set("truc", "bidule");
-maMap.set(1, "toto");
-
-maMap.size;        // 2
-maMap.has("truc"); // true
-
-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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 814e9e22ea..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Map.prototype.delete() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete -original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

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")}}
- - - -

Syntaxe

- -
maMap.delete(clé);
- -

Paramètres

- -
-
clé
-
Ce paramètre obligatoire correspond à la clé de l'élément qu'on souhaite retirer de l'objet Map.
-
- -

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.

- -

Exemples

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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index d464cd80c1..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Map.prototype.entries() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries -original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{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.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-entries.html")}}
- - - -

Syntaxe

- -
maMap.entries()
- -

Valeur de retour

- -

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

- -

Exemple

- -

Utiliser entries()

- -
var maMap = new Map();
-maMap.set("0", "toto");
-maMap.set(1, "truc");
-maMap.set({}, "bidule");
-
-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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index ecc3e13e12..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach -original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{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.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}}
- - - -

Syntaxe

- -
maMap.forEach(callback[, thisArg])
- -

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

Valeur de retour

- -

{{jsxref("undefined")}}

- -

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.

- -

callback est appelé avec trois arguments :

- - - -

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.

- -

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.

- -

Exemples

- -

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

- -
function logMapElements(valeur, clé, map) {
-    console.log(`map.get('${clé}') = ${value}`);
-}
-
-
-new Map([["toto", 3], ["truc", {}], ["bidule", undefined]]).forEach(logMapElements);
-// affichera dans la console :
-// "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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 3d778e6c82..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.get() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get -original_slug: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{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.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-get.html")}}
- - - -

Syntaxe

- -
maMap.get(clé)
- -

Paramètres

- -
-
clé
-
La clé de l'élément à renvoyer depuis l'objet Map.
-
- -

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.

- -

Exemples

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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 052d8fb6d9..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.has() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has -original_slug: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

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")}}
- - - -

Syntaxe

- -
maMap.has(clé);
- -

Paramètres

- -
-
clé
-
Ce paramètre obligatoire correspond à la clé dont on veut savoir si elle appartient à l'objet Map.
-
- -

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.

- -

Exemples

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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index ff9d204289..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,276 +0,0 @@ ---- -title: Map -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map -original_slug: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{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'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

- -
new Map([iterable])
- -

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")}}.
-
- -

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.

- -

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

- -

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

- - - -

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.

- -

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 :

- - - -

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

Instances de Map

- -

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

- -

Propriétés

- -

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

- -

Méthodes

- -

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

- -

Exemples

- -

Utiliser un objet Map

- -
const myMap = new Map();
-
-const objectKey = {},
-    functionKey = function () {},
-    stringKey = "une chaîne";
-
-// définir les valeurs
-myMap.set(stringKey, "valeur associée à 'une chaîne'");
-myMap.set(objectKey, "valeur associée à objectKey");
-myMap.set(functionKey, "valeur associée à functionKey");
-
-myMap.size; // 3
-
-// récupérer les valeurs
-myMap.get(stringKey);     // "valeur associée à 'une chaîne'"
-myMap.get(objectKey);      // "valeur associée à objetClé"
-myMap.get(functionKey);   // "valeur associée à fonctionClé"
-
-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é

- -

{{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();
-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

- -

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

- -
const myMap = new Map();
-myMap.set(0, "zéro");
-myMap.set(1, "un");
-for (const [key, value] of myMap) {
-  console.log(`${key} = ${value}`);
-}
-// On aura 2 lignes : la première avec "0 = zéro"
-// la seconde avec "1 = un"
-
-for (const key of myMap.keys()) {
-  console.log(key);
-}
-// On aura 2 lignes : la première avec "0"
-// et la seconde avec "1"
-
-for (const value of myMap.values()) {
-  console.log(valeur);
-}
-// On aura 2 lignes : la première avec "zéro"
-// et la seconde avec "un"
-
-for (const [key, value] of myMap.entries()) {
-  console.log(`${key} = ${value}`);
-}
-// On aura 2 lignes : la première avec "0 = zéro"
-// la seconde avec "1 = un"
-
-myMap.forEach(function(value, key) {
-  console.log(`${key} = ${value}`);
-});
-// On aura 2 lignes : la première avec "0 = zéro"
-// la seconde avec "1 = un"
-
- -

Relation avec les objets Array

- -
const keyValuePair = [["clé1", "valeur1"], ["clé2", "valeur2"]];
-
-// On utilise le constructeur Map
-// pour transformer un tableau de clés/valeurs
-// en un objet map
-const myMap = new Map(keyValuePair);
-
-myMap.get("clé1"); // renvoie "valeur1"
-
-// On utilise la fonction Array.from pour transformer
-// une map en un tableau de clés/valeurs
-console.log(Array.from(myMap)); // affichera la même chose que tableauCléValeur
-
-// 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"]
- -

Cloner et fusionner des objets Map

- -

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

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

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 :

- -
const first = new Map([
-  [1, 'un'],
-  [2, 'deux'],
-  [3, 'trois'],
-]);
-
-const second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// On fusionne les deux maps. C'est la "dernière" version
-// de la clé qui l'emporte.
-// L'opérateur de décomposition nous permet principalement ici
-// de convertir une map en un tableau
-const fusion = new Map([...first, ...second]);
-
-console.log(fusion.get(1)); // uno
-console.log(fusion.get(2)); // dos
-console.log(fusion.get(3)); // trois
- -

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

- -
const first = new Map([
-  [1, 'un'],
-  [2, 'deux'],
-  [3, 'trois'],
-]);
-
-const second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// On peut fusionner des Maps avec un tableau
-// Là encore c'est le dernier exemplaire de la clé qui l'emporte
-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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index c57e06c9b9..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.keys() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Méthode - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys -original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{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.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-keys.html")}}
- - - -

Syntaxe

- -
maMap.keys()
- -

Valeur de retour

- -

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

- -

Exemples

- -

Utiliser keys()

- -
var maMap = new Map();
-maMap.set("0", "toto");
-maMap.set(1, "truc");
-maMap.set({}, "bidule");
-
-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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 3b6e5f8612..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Map.prototype.set() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set -original_slug: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

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")}}
- - - -

Syntaxe

- -
maMap.set(clé, valeur);
- -

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

Valeur de retour

- -

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

- -

Exemples

- -

Utiliser la méthode set()

- -
var maMap = new Map();
-
-// On ajoute de nouveaux éléments à l'objet map
-maMap.set("truc", "toto");
-maMap.set(1, "bidule");
-
-// On met à jour un élément
-maMap.set("truc", "fuuu");
-
- -

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 :

- -
// 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

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 59f85f7a91..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Map.prototype.size -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Propriété - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size -original_slug: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

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")}}
- - - -

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é.

- -

Exemple

- -

Utiliser size

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

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')}} 
- -

Compatibliité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 34c7d20f78..0000000000 --- a/files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.values() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Méthode - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values -original_slug: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
{{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.

- -
{{EmbedInteractiveExample("pages/js/map-prototype-values.html")}}
- - - -

Syntaxe

- -
maMap.values()
- -

Valeur de retour

- -

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

- -

Exemple

- -

Utiliser values()

- -
var maMap = new Map();
-maMap.set("0", "toto");
-maMap.set(1, "truc");
-maMap.set({}, "licorne");
-
-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

- - diff --git a/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html new file mode 100644 index 0000000000..4951be38ba --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html @@ -0,0 +1,91 @@ +--- +title: Map.prototype[@@iterator]() +slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +--- +
{{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")}}.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-@@iterator.html")}}
+ + + +

Syntaxe

+ +
maMap[Symbol.iterator]
+ +

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()")}}.

+ +

Exemples

+ +

Utiliser [@@iterator]()

+ +
var maMap = new Map();
+maMap.set("0", "toto");
+maMap.set(1, "truc");
+maMap.set({}, "bidule");
+
+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

+ +
var maMap = new Map();
+maMap.set("0", "toto");
+maMap.set(1, "truc");
+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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/@@species/index.html b/files/fr/web/javascript/reference/global_objects/map/@@species/index.html new file mode 100644 index 0000000000..dddc3795f8 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/@@species/index.html @@ -0,0 +1,71 @@ +--- +title: get Map[@@species] +slug: Web/JavaScript/Reference/Global_Objects/Map/@@species +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Propriété + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species +--- +
{{JSRef}}
+ +

Map[@@species] renvoie le constructeur Map.

+ +

Syntaxe

+ +
Map[Symbol.species]
+
+ +

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

+ +

Exemples

+ +

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

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 {
+  // 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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html new file mode 100644 index 0000000000..61b0bace74 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,56 @@ +--- +title: Map.prototype[@@toStringTag]() +slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +--- +
{{JSRef}}
+ +

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

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-@@tostringtag.html")}}
+ + + +
{{js_property_attributes(0,0,1)}}
+ +

Syntaxe

+ +
Map[Symbol.toStringTag]
+ +

Exemple

+ +
Object.prototype.toString.call(new Map()) // "[object Map]"
+ +

Spécifications

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

+ +

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

diff --git a/files/fr/web/javascript/reference/global_objects/map/clear/index.html b/files/fr/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..9767b638a4 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.clear() +slug: Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

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

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-clear.html")}}
+ + + +

Syntaxe

+ +
maMap.clear();
+ +

Valeur de retour

+ +

{{jsxref("undefined")}}.

+ +

Exemple

+ +

Utiliser la méthode clear()

+ +
var maMap = new Map();
+maMap.set("truc", "bidule");
+maMap.set(1, "toto");
+
+maMap.size;        // 2
+maMap.has("truc"); // true
+
+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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/delete/index.html b/files/fr/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..618a01305b --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,76 @@ +--- +title: Map.prototype.delete() +slug: Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

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")}}
+ + + +

Syntaxe

+ +
maMap.delete(clé);
+ +

Paramètres

+ +
+
clé
+
Ce paramètre obligatoire correspond à la clé de l'élément qu'on souhaite retirer de l'objet Map.
+
+ +

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.

+ +

Exemples

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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/entries/index.html b/files/fr/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..434717d5be --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,80 @@ +--- +title: Map.prototype.entries() +slug: Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{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.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-entries.html")}}
+ + + +

Syntaxe

+ +
maMap.entries()
+ +

Valeur de retour

+ +

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

+ +

Exemple

+ +

Utiliser entries()

+ +
var maMap = new Map();
+maMap.set("0", "toto");
+maMap.set(1, "truc");
+maMap.set({}, "bidule");
+
+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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/foreach/index.html b/files/fr/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..52fccee803 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,104 @@ +--- +title: Map.prototype.forEach() +slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{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.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}}
+ + + +

Syntaxe

+ +
maMap.forEach(callback[, thisArg])
+ +

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

Valeur de retour

+ +

{{jsxref("undefined")}}

+ +

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.

+ +

callback est appelé avec trois arguments :

+ + + +

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.

+ +

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.

+ +

Exemples

+ +

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

+ +
function logMapElements(valeur, clé, map) {
+    console.log(`map.get('${clé}') = ${value}`);
+}
+
+
+new Map([["toto", 3], ["truc", {}], ["bidule", undefined]]).forEach(logMapElements);
+// affichera dans la console :
+// "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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/get/index.html b/files/fr/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..f7cde0e13d --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.get() +slug: Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{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.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-get.html")}}
+ + + +

Syntaxe

+ +
maMap.get(clé)
+ +

Paramètres

+ +
+
clé
+
La clé de l'élément à renvoyer depuis l'objet Map.
+
+ +

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.

+ +

Exemples

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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/has/index.html b/files/fr/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..6096a799c7 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.has() +slug: Web/JavaScript/Reference/Global_Objects/Map/has +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

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")}}
+ + + +

Syntaxe

+ +
maMap.has(clé);
+ +

Paramètres

+ +
+
clé
+
Ce paramètre obligatoire correspond à la clé dont on veut savoir si elle appartient à l'objet Map.
+
+ +

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.

+ +

Exemples

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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/index.html b/files/fr/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..7e49822844 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,276 @@ +--- +title: Map +slug: Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{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'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

+ +
new Map([iterable])
+ +

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

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.

+ +

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

+ +

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

+ + + +

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.

+ +

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 :

+ + + +

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

Instances de Map

+ +

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

+ +

Propriétés

+ +

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

+ +

Méthodes

+ +

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

+ +

Exemples

+ +

Utiliser un objet Map

+ +
const myMap = new Map();
+
+const objectKey = {},
+    functionKey = function () {},
+    stringKey = "une chaîne";
+
+// définir les valeurs
+myMap.set(stringKey, "valeur associée à 'une chaîne'");
+myMap.set(objectKey, "valeur associée à objectKey");
+myMap.set(functionKey, "valeur associée à functionKey");
+
+myMap.size; // 3
+
+// récupérer les valeurs
+myMap.get(stringKey);     // "valeur associée à 'une chaîne'"
+myMap.get(objectKey);      // "valeur associée à objetClé"
+myMap.get(functionKey);   // "valeur associée à fonctionClé"
+
+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é

+ +

{{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();
+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

+ +

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

+ +
const myMap = new Map();
+myMap.set(0, "zéro");
+myMap.set(1, "un");
+for (const [key, value] of myMap) {
+  console.log(`${key} = ${value}`);
+}
+// On aura 2 lignes : la première avec "0 = zéro"
+// la seconde avec "1 = un"
+
+for (const key of myMap.keys()) {
+  console.log(key);
+}
+// On aura 2 lignes : la première avec "0"
+// et la seconde avec "1"
+
+for (const value of myMap.values()) {
+  console.log(valeur);
+}
+// On aura 2 lignes : la première avec "zéro"
+// et la seconde avec "un"
+
+for (const [key, value] of myMap.entries()) {
+  console.log(`${key} = ${value}`);
+}
+// On aura 2 lignes : la première avec "0 = zéro"
+// la seconde avec "1 = un"
+
+myMap.forEach(function(value, key) {
+  console.log(`${key} = ${value}`);
+});
+// On aura 2 lignes : la première avec "0 = zéro"
+// la seconde avec "1 = un"
+
+ +

Relation avec les objets Array

+ +
const keyValuePair = [["clé1", "valeur1"], ["clé2", "valeur2"]];
+
+// On utilise le constructeur Map
+// pour transformer un tableau de clés/valeurs
+// en un objet map
+const myMap = new Map(keyValuePair);
+
+myMap.get("clé1"); // renvoie "valeur1"
+
+// On utilise la fonction Array.from pour transformer
+// une map en un tableau de clés/valeurs
+console.log(Array.from(myMap)); // affichera la même chose que tableauCléValeur
+
+// 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"]
+ +

Cloner et fusionner des objets Map

+ +

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

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

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 :

+ +
const first = new Map([
+  [1, 'un'],
+  [2, 'deux'],
+  [3, 'trois'],
+]);
+
+const second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// On fusionne les deux maps. C'est la "dernière" version
+// de la clé qui l'emporte.
+// L'opérateur de décomposition nous permet principalement ici
+// de convertir une map en un tableau
+const fusion = new Map([...first, ...second]);
+
+console.log(fusion.get(1)); // uno
+console.log(fusion.get(2)); // dos
+console.log(fusion.get(3)); // trois
+ +

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

+ +
const first = new Map([
+  [1, 'un'],
+  [2, 'deux'],
+  [3, 'trois'],
+]);
+
+const second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// On peut fusionner des Maps avec un tableau
+// Là encore c'est le dernier exemplaire de la clé qui l'emporte
+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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/keys/index.html b/files/fr/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..b74adc65bf --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.keys() +slug: Web/JavaScript/Reference/Global_Objects/Map/keys +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Méthode + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{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.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-keys.html")}}
+ + + +

Syntaxe

+ +
maMap.keys()
+ +

Valeur de retour

+ +

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

+ +

Exemples

+ +

Utiliser keys()

+ +
var maMap = new Map();
+maMap.set("0", "toto");
+maMap.set(1, "truc");
+maMap.set({}, "bidule");
+
+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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/set/index.html b/files/fr/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..4edbb8584a --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,95 @@ +--- +title: Map.prototype.set() +slug: Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

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")}}
+ + + +

Syntaxe

+ +
maMap.set(clé, valeur);
+ +

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

Valeur de retour

+ +

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

+ +

Exemples

+ +

Utiliser la méthode set()

+ +
var maMap = new Map();
+
+// On ajoute de nouveaux éléments à l'objet map
+maMap.set("truc", "toto");
+maMap.set(1, "bidule");
+
+// On met à jour un élément
+maMap.set("truc", "fuuu");
+
+ +

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 :

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

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/size/index.html b/files/fr/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..2a60b09775 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,67 @@ +--- +title: Map.prototype.size +slug: Web/JavaScript/Reference/Global_Objects/Map/size +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Propriété + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

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")}}
+ + + +

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é.

+ +

Exemple

+ +

Utiliser size

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

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')}} 
+ +

Compatibliité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/javascript/reference/global_objects/map/values/index.html b/files/fr/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..40ae09fad9 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.values() +slug: Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Méthode + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{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.

+ +
{{EmbedInteractiveExample("pages/js/map-prototype-values.html")}}
+ + + +

Syntaxe

+ +
maMap.values()
+ +

Valeur de retour

+ +

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

+ +

Exemple

+ +

Utiliser values()

+ +
var maMap = new Map();
+maMap.set("0", "toto");
+maMap.set(1, "truc");
+maMap.set({}, "licorne");
+
+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

+ + -- cgit v1.2.3-54-g00ecf