From 52ccdf1f0a1cee3f0659ac78e81c79dae152399b Mon Sep 17 00:00:00 2001 From: MDN Date: Wed, 23 Jun 2021 00:34:06 +0000 Subject: [CRON] sync translated content --- files/de/_redirects.txt | 15 + files/de/_wikihistory.json | 202 ++++----- .../orphaned/web/api/node/setuserdata/index.html | 122 ++++++ .../global_objects/map/@@iterator/index.html | 103 +++++ .../global_objects/map/@@species/index.html | 73 ++++ .../global_objects/map/@@tostringtag/index.html | 59 +++ .../reference/global_objects/map/clear/index.html | 78 ++++ .../reference/global_objects/map/delete/index.html | 74 ++++ .../global_objects/map/entries/index.html | 79 ++++ .../global_objects/map/foreach/index.html | 105 +++++ .../reference/global_objects/map/get/index.html | 81 ++++ .../reference/global_objects/map/has/index.html | 84 ++++ .../reference/global_objects/map/index.html | 208 ++++++++++ .../reference/global_objects/map/keys/index.html | 70 ++++ .../reference/global_objects/map/set/index.html | 97 +++++ .../reference/global_objects/map/size/index.html | 68 +++ .../reference/global_objects/map/values/index.html | 78 ++++ files/de/web/api/node/setuserdata/index.html | 121 ------ .../global_objects/map/@@iterator/index.html | 102 ----- .../global_objects/map/@@species/index.html | 72 ---- .../global_objects/map/@@tostringtag/index.html | 58 --- .../reference/global_objects/map/clear/index.html | 77 ---- .../reference/global_objects/map/delete/index.html | 73 ---- .../global_objects/map/entries/index.html | 78 ---- .../global_objects/map/foreach/index.html | 104 ----- .../reference/global_objects/map/get/index.html | 80 ---- .../reference/global_objects/map/has/index.html | 83 ---- .../reference/global_objects/map/index.html | 207 ---------- .../reference/global_objects/map/keys/index.html | 69 ---- .../reference/global_objects/map/set/index.html | 96 ----- .../reference/global_objects/map/size/index.html | 67 --- .../reference/global_objects/map/values/index.html | 77 ---- files/es/_redirects.txt | 33 +- files/es/_wikihistory.json | 168 ++++---- .../reference/global_objects/map/clear/index.html | 110 +++++ .../reference/global_objects/map/delete/index.html | 115 ++++++ .../global_objects/map/entries/index.html | 110 +++++ .../global_objects/map/foreach/index.html | 95 +++++ .../reference/global_objects/map/get/index.html | 78 ++++ .../reference/global_objects/map/has/index.html | 66 +++ .../reference/global_objects/map/index.html | 214 ++++++++++ .../reference/global_objects/map/keys/index.html | 110 +++++ .../reference/global_objects/map/set/index.html | 134 ++++++ .../reference/global_objects/map/size/index.html | 111 +++++ .../reference/global_objects/map/values/index.html | 78 ++++ .../reference/global_objects/map/clear/index.html | 110 ----- .../reference/global_objects/map/delete/index.html | 115 ------ .../global_objects/map/entries/index.html | 110 ----- .../global_objects/map/foreach/index.html | 95 ----- .../reference/global_objects/map/get/index.html | 78 ---- .../reference/global_objects/map/has/index.html | 66 --- .../reference/global_objects/map/index.html | 214 ---------- .../reference/global_objects/map/keys/index.html | 110 ----- .../reference/global_objects/map/set/index.html | 134 ------ .../reference/global_objects/map/size/index.html | 111 ----- .../reference/global_objects/map/values/index.html | 78 ---- files/fr/_redirects.txt | 67 +-- files/fr/_wikihistory.json | 248 +++++------ files/fr/orphaned/web/api/domuserdata/index.html | 45 ++ .../orphaned/web/api/node/getuserdata/index.html | 69 ++++ .../orphaned/web/api/node/setuserdata/index.html | 78 ++++ .../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 ++++ files/fr/web/api/domuserdata/index.html | 44 -- files/fr/web/api/node/getuserdata/index.html | 68 --- files/fr/web/api/node/setuserdata/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 ---- files/ja/_redirects.txt | 20 +- files/ja/_wikihistory.json | 310 +++++++------- .../orphaned/web/api/node/getuserdata/index.html | 69 ++++ .../global_objects/map/@@iterator/index.html | 96 +++++ .../global_objects/map/@@species/index.html | 65 +++ .../global_objects/map/@@tostringtag/index.html | 61 +++ .../reference/global_objects/map/clear/index.html | 73 ++++ .../reference/global_objects/map/delete/index.html | 76 ++++ .../global_objects/map/entries/index.html | 72 ++++ .../global_objects/map/foreach/index.html | 108 +++++ .../reference/global_objects/map/get/index.html | 73 ++++ .../reference/global_objects/map/has/index.html | 73 ++++ .../reference/global_objects/map/index.html | 370 +++++++++++++++++ .../reference/global_objects/map/keys/index.html | 72 ++++ .../reference/global_objects/map/map/index.html | 65 +++ .../reference/global_objects/map/set/index.html | 88 ++++ .../reference/global_objects/map/size/index.html | 61 +++ .../reference/global_objects/map/values/index.html | 71 ++++ files/ja/web/api/node/getuserdata/index.html | 68 --- .../global_objects/map/@@iterator/index.html | 95 ----- .../global_objects/map/@@species/index.html | 64 --- .../global_objects/map/@@tostringtag/index.html | 60 --- .../reference/global_objects/map/clear/index.html | 72 ---- .../reference/global_objects/map/delete/index.html | 75 ---- .../global_objects/map/entries/index.html | 71 ---- .../global_objects/map/foreach/index.html | 107 ----- .../reference/global_objects/map/get/index.html | 72 ---- .../reference/global_objects/map/has/index.html | 72 ---- .../reference/global_objects/map/index.html | 369 ----------------- .../reference/global_objects/map/keys/index.html | 71 ---- .../reference/global_objects/map/map/index.html | 64 --- .../reference/global_objects/map/set/index.html | 87 ---- .../reference/global_objects/map/size/index.html | 60 --- .../reference/global_objects/map/values/index.html | 70 ---- files/ko/_redirects.txt | 11 + files/ko/_wikihistory.json | 144 +++---- .../global_objects/map/@@tostringtag/index.html | 52 +++ .../reference/global_objects/map/clear/index.html | 76 ++++ .../reference/global_objects/map/delete/index.html | 80 ++++ .../global_objects/map/entries/index.html | 79 ++++ .../global_objects/map/foreach/index.html | 99 +++++ .../reference/global_objects/map/get/index.html | 81 ++++ .../reference/global_objects/map/has/index.html | 82 ++++ .../reference/global_objects/map/index.html | 245 +++++++++++ .../reference/global_objects/map/map/index.html | 61 +++ .../reference/global_objects/map/set/index.html | 97 +++++ .../reference/global_objects/map/size/index.html | 63 +++ .../global_objects/map/@@tostringtag/index.html | 51 --- .../reference/global_objects/map/clear/index.html | 75 ---- .../reference/global_objects/map/delete/index.html | 79 ---- .../global_objects/map/entries/index.html | 78 ---- .../global_objects/map/foreach/index.html | 98 ----- .../reference/global_objects/map/get/index.html | 80 ---- .../reference/global_objects/map/has/index.html | 81 ---- .../reference/global_objects/map/index.html | 244 ----------- .../reference/global_objects/map/map/index.html | 60 --- .../reference/global_objects/map/set/index.html | 96 ----- .../reference/global_objects/map/size/index.html | 62 --- files/pl/_redirects.txt | 33 +- files/pl/_wikihistory.json | 142 +++---- .../reference/global_objects/map/clear/index.html | 88 ++++ .../reference/global_objects/map/delete/index.html | 86 ++++ .../global_objects/map/entries/index.html | 129 ++++++ .../global_objects/map/foreach/index.html | 105 +++++ .../reference/global_objects/map/get/index.html | 81 ++++ .../reference/global_objects/map/has/index.html | 86 ++++ .../reference/global_objects/map/index.html | 459 +++++++++++++++++++++ .../reference/global_objects/map/keys/index.html | 79 ++++ .../reference/global_objects/map/set/index.html | 97 +++++ .../reference/global_objects/map/size/index.html | 66 +++ .../reference/global_objects/map/values/index.html | 78 ++++ .../reference/global_objects/map/clear/index.html | 88 ---- .../reference/global_objects/map/delete/index.html | 86 ---- .../global_objects/map/entries/index.html | 129 ------ .../global_objects/map/foreach/index.html | 105 ----- .../reference/global_objects/map/get/index.html | 81 ---- .../reference/global_objects/map/has/index.html | 86 ---- .../reference/global_objects/map/index.html | 459 --------------------- .../reference/global_objects/map/keys/index.html | 79 ---- .../reference/global_objects/map/set/index.html | 97 ----- .../reference/global_objects/map/size/index.html | 66 --- .../reference/global_objects/map/values/index.html | 78 ---- files/pt-br/_redirects.txt | 11 + files/pt-br/_wikihistory.json | 158 +++---- .../reference/global_objects/map/clear/index.html | 120 ++++++ .../reference/global_objects/map/delete/index.html | 121 ++++++ .../global_objects/map/entries/index.html | 121 ++++++ .../global_objects/map/foreach/index.html | 147 +++++++ .../reference/global_objects/map/get/index.html | 75 ++++ .../reference/global_objects/map/has/index.html | 77 ++++ .../reference/global_objects/map/index.html | 226 ++++++++++ .../reference/global_objects/map/keys/index.html | 116 ++++++ .../reference/global_objects/map/set/index.html | 138 +++++++ .../reference/global_objects/map/size/index.html | 111 +++++ .../reference/global_objects/map/values/index.html | 75 ++++ .../reference/global_objects/map/clear/index.html | 119 ------ .../reference/global_objects/map/delete/index.html | 120 ------ .../global_objects/map/entries/index.html | 120 ------ .../global_objects/map/foreach/index.html | 146 ------- .../reference/global_objects/map/get/index.html | 74 ---- .../reference/global_objects/map/has/index.html | 76 ---- .../reference/global_objects/map/index.html | 225 ---------- .../reference/global_objects/map/keys/index.html | 115 ------ .../reference/global_objects/map/set/index.html | 137 ------ .../reference/global_objects/map/size/index.html | 110 ----- .../reference/global_objects/map/values/index.html | 74 ---- files/ru/_redirects.txt | 13 + files/ru/_wikihistory.json | 200 ++++----- .../orphaned/web/api/node/getuserdata/index.html | 64 +++ .../global_objects/map/@@species/index.html | 64 +++ .../reference/global_objects/map/clear/index.html | 72 ++++ .../reference/global_objects/map/delete/index.html | 77 ++++ .../global_objects/map/entries/index.html | 76 ++++ .../global_objects/map/foreach/index.html | 95 +++++ .../reference/global_objects/map/get/index.html | 69 ++++ .../reference/global_objects/map/has/index.html | 72 ++++ .../reference/global_objects/map/index.html | 286 +++++++++++++ .../reference/global_objects/map/keys/index.html | 66 +++ .../reference/global_objects/map/set/index.html | 89 ++++ .../reference/global_objects/map/size/index.html | 65 +++ .../reference/global_objects/map/values/index.html | 65 +++ files/ru/web/api/node/getuserdata/index.html | 63 --- .../global_objects/map/@@species/index.html | 63 --- .../reference/global_objects/map/clear/index.html | 71 ---- .../reference/global_objects/map/delete/index.html | 76 ---- .../global_objects/map/entries/index.html | 75 ---- .../global_objects/map/foreach/index.html | 94 ----- .../reference/global_objects/map/get/index.html | 68 --- .../reference/global_objects/map/has/index.html | 71 ---- .../reference/global_objects/map/index.html | 285 ------------- .../reference/global_objects/map/keys/index.html | 65 --- .../reference/global_objects/map/set/index.html | 88 ---- .../reference/global_objects/map/size/index.html | 64 --- .../reference/global_objects/map/values/index.html | 64 --- files/zh-cn/_redirects.txt | 29 +- files/zh-cn/_wikihistory.json | 320 +++++++------- .../orphaned/web/api/node/getuserdata/index.html | 97 +++++ .../orphaned/web/api/node/setuserdata/index.html | 104 +++++ .../global_objects/map/@@iterator/index.html | 102 +++++ .../global_objects/map/@@species/index.html | 68 +++ .../global_objects/map/@@tostringtag/index.html | 96 +++++ .../reference/global_objects/map/clear/index.html | 77 ++++ .../reference/global_objects/map/delete/index.html | 84 ++++ .../global_objects/map/entries/index.html | 73 ++++ .../global_objects/map/foreach/index.html | 110 +++++ .../reference/global_objects/map/get/index.html | 82 ++++ .../reference/global_objects/map/has/index.html | 121 ++++++ .../reference/global_objects/map/index.html | 341 +++++++++++++++ .../reference/global_objects/map/keys/index.html | 80 ++++ .../reference/global_objects/map/map/index.html | 58 +++ .../reference/global_objects/map/set/index.html | 97 +++++ .../reference/global_objects/map/size/index.html | 78 ++++ .../reference/global_objects/map/values/index.html | 113 +++++ files/zh-cn/web/api/node/getuserdata/index.html | 96 ----- files/zh-cn/web/api/node/setuserdata/index.html | 103 ----- .../global_objects/map/@@iterator/index.html | 101 ----- .../global_objects/map/@@species/index.html | 67 --- .../global_objects/map/@@tostringtag/index.html | 95 ----- .../reference/global_objects/map/clear/index.html | 76 ---- .../reference/global_objects/map/delete/index.html | 83 ---- .../global_objects/map/entries/index.html | 72 ---- .../global_objects/map/foreach/index.html | 109 ----- .../reference/global_objects/map/get/index.html | 81 ---- .../reference/global_objects/map/has/index.html | 120 ------ .../reference/global_objects/map/index.html | 340 --------------- .../reference/global_objects/map/keys/index.html | 79 ---- .../reference/global_objects/map/map/index.html | 57 --- .../reference/global_objects/map/set/index.html | 96 ----- .../reference/global_objects/map/size/index.html | 77 ---- .../reference/global_objects/map/values/index.html | 112 ----- files/zh-tw/_redirects.txt | 1 + files/zh-tw/_wikihistory.json | 18 +- .../reference/global_objects/map/index.html | 266 ++++++++++++ .../reference/global_objects/map/index.html | 265 ------------ 266 files changed, 13624 insertions(+), 13414 deletions(-) create mode 100644 files/de/orphaned/web/api/node/setuserdata/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/de/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/de/web/api/node/setuserdata/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/@@iterator/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/de/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/es/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/es/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/fr/orphaned/web/api/domuserdata/index.html create mode 100644 files/fr/orphaned/web/api/node/getuserdata/index.html create mode 100644 files/fr/orphaned/web/api/node/setuserdata/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/fr/web/api/domuserdata/index.html delete mode 100644 files/fr/web/api/node/getuserdata/index.html delete mode 100644 files/fr/web/api/node/setuserdata/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/fr/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/ja/orphaned/web/api/node/getuserdata/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/map/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/ja/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/ja/web/api/node/getuserdata/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/@@iterator/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/map/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/ja/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/map/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/ko/orphaned/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/map/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/ko/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/pl/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/pl/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/pt-br/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/pt-br/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/ru/orphaned/web/api/node/getuserdata/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/ru/web/api/node/getuserdata/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/zh-cn/orphaned/web/api/node/getuserdata/index.html create mode 100644 files/zh-cn/orphaned/web/api/node/setuserdata/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@species/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/clear/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/delete/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/entries/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/foreach/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/get/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/has/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/keys/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/map/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/set/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/size/index.html create mode 100644 files/zh-cn/orphaned/web/javascript/reference/global_objects/map/values/index.html delete mode 100644 files/zh-cn/web/api/node/getuserdata/index.html delete mode 100644 files/zh-cn/web/api/node/setuserdata/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/@@iterator/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/@@species/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/@@tostringtag/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/clear/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/delete/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/entries/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/foreach/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/get/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/has/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/keys/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/map/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/set/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/size/index.html delete mode 100644 files/zh-cn/web/javascript/reference/global_objects/map/values/index.html create mode 100644 files/zh-tw/orphaned/web/javascript/reference/global_objects/map/index.html delete mode 100644 files/zh-tw/web/javascript/reference/global_objects/map/index.html (limited to 'files') diff --git a/files/de/_redirects.txt b/files/de/_redirects.txt index e432df5c64..218ad43488 100644 --- a/files/de/_redirects.txt +++ b/files/de/_redirects.txt @@ -496,6 +496,7 @@ /de/docs/Web/API/Navigator/registerProtocolHandler/Webbasierte_protokoll-handler /de/docs/Web/API/Navigator/registerProtocolHandler/Web-based_protocol_handlers /de/docs/Web/API/Node.cloneNode /de/docs/Web/API/Node/cloneNode /de/docs/Web/API/Node/innerText /de/docs/Web/API/HTMLElement/innerText +/de/docs/Web/API/Node/setUserData /de/docs/orphaned/Web/API/Node/setUserData /de/docs/Web/API/Vollbild_API /de/docs/Web/API/Fullscreen_API /de/docs/Web/API/WebGL_API/3D-Objekte_mit_WebGL_erstellen /de/docs/Web/API/WebGL_API/Tutorial/Creating_3D_objects_using_WebGL /de/docs/Web/API/WebGL_API/Animierte_Texturen_in_WebGL /de/docs/Web/API/WebGL_API/Tutorial/Animating_textures_in_WebGL @@ -847,7 +848,21 @@ /de/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype /de/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/Collator /de/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype /de/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /de/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype /de/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat +/de/docs/Web/JavaScript/Reference/Global_Objects/Map /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/get /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/has /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /de/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /de/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/set /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/size /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/de/docs/Web/JavaScript/Reference/Global_Objects/Map/values /de/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /de/docs/Web/JavaScript/Reference/Global_Objects/Math/math.random /de/docs/Web/JavaScript/Reference/Global_Objects/Math/random /de/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /de/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /de/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /de/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat diff --git a/files/de/_wikihistory.json b/files/de/_wikihistory.json index f8653af90c..efbaf9dc4e 100644 --- a/files/de/_wikihistory.json +++ b/files/de/_wikihistory.json @@ -3880,12 +3880,6 @@ "Jonas" ] }, - "Web/API/Node/setUserData": { - "modified": "2019-03-23T22:05:46.565Z", - "contributors": [ - "Nonononoki" - ] - }, "Web/API/Node/textContent": { "modified": "2020-10-15T21:19:51.146Z", "contributors": [ @@ -11889,101 +11883,6 @@ "blub0hr" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:39:41.133Z", - "contributors": [ - "verij51", - "Streamities", - "kdex", - "Flonk", - "schlagi123", - "the-bluesnik", - "GinoHereIam", - "Chris-CR", - "Fearodin" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { - "modified": "2020-10-15T22:01:27.148Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@species": { - "modified": "2020-10-15T22:01:26.820Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { - "modified": "2020-10-15T22:01:26.636Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-10-15T22:01:24.339Z", - "contributors": [ - "shaedrich", - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T22:01:25.242Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2020-10-15T22:01:26.606Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T21:53:59.055Z", - "contributors": [ - "schlagi123", - "Techworker" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T22:01:25.184Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T22:01:25.655Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2020-10-15T21:57:34.550Z", - "contributors": [ - "schlagi123", - "patpir" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-15T22:01:24.339Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-10-15T22:01:24.292Z", - "contributors": [ - "schlagi123" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-10-15T22:01:25.714Z", - "contributors": [ - "schlagi123" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:32:16.402Z", "contributors": [ @@ -14682,6 +14581,12 @@ "Sebastianz" ] }, + "orphaned/Web/API/Node/setUserData": { + "modified": "2019-03-23T22:05:46.565Z", + "contributors": [ + "Nonononoki" + ] + }, "orphaned/Web/CSS/:-moz-ui-valid": { "modified": "2019-03-23T22:42:34.212Z", "contributors": [ @@ -14786,6 +14691,101 @@ "schlagi123" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:39:41.133Z", + "contributors": [ + "verij51", + "Streamities", + "kdex", + "Flonk", + "schlagi123", + "the-bluesnik", + "GinoHereIam", + "Chris-CR", + "Fearodin" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { + "modified": "2020-10-15T22:01:27.148Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species": { + "modified": "2020-10-15T22:01:26.820Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { + "modified": "2020-10-15T22:01:26.636Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-10-15T22:01:24.339Z", + "contributors": [ + "shaedrich", + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T22:01:25.242Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2020-10-15T22:01:26.606Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T21:53:59.055Z", + "contributors": [ + "schlagi123", + "Techworker" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T22:01:25.184Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T22:01:25.655Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2020-10-15T21:57:34.550Z", + "contributors": [ + "schlagi123", + "patpir" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-15T22:01:24.339Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-10-15T22:01:24.292Z", + "contributors": [ + "schlagi123" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-10-15T22:01:25.714Z", + "contributors": [ + "schlagi123" + ] + }, "orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator": { "modified": "2020-10-15T22:05:45.089Z", "contributors": [ diff --git a/files/de/orphaned/web/api/node/setuserdata/index.html b/files/de/orphaned/web/api/node/setuserdata/index.html new file mode 100644 index 0000000000..dcaa121c54 --- /dev/null +++ b/files/de/orphaned/web/api/node/setuserdata/index.html @@ -0,0 +1,122 @@ +--- +title: Node.setUserData() +slug: orphaned/Web/API/Node/setUserData +translation_of: Web/API/Node/setUserData +original_slug: Web/API/Node/setUserData +--- +
{{APIRef("DOM")}}{{obsolete_header}}
+ +

Die Methode Node.setUserData()erlaubt es dem Benutzer Daten dem Element hinzuzufügen (oder löschen), ohne dabei die DOM zu modifizieren. Beachte dabei, dass die Daten durch das Nutzen von {{domxref("Node.importNode")}}, {{domxref("Node.cloneNode()")}} und {{domxref("Node.renameNode()")}} nicht mitgegeben werden kann (jedoch kann {{domxref("Node.adoptNode")}} die Information behalten), und bei Vergleichstest mit {{domxref("Node.isEqualNode()")}} werden die Daten nicht berücksichtigt.

+ +

This method offers the convenience of associating data with specific nodes without needing to alter the structure of a document and in a standard fashion, but it also means that extra steps may need to be taken if one wishes to serialize the information or include the information upon clone, import, or rename operations.

+ +
+

The Node.getUserData and {{domxref("Node.setUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

+
+ +

Syntax

+ +
var prevUserData = someNode.setUserData(userKey, userData, handler);
+ +

Parameters

+ + + +

Beispiel

+ +
var d = document.implementation.createDocument('', 'test', null);
+d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
+console.log(d.documentElement.getUserData('key')); // 15
+var e = document.importNode(d.documentElement, true); // causes handler to be called
+console.log(e.getUserData('key')); // null since user data is not copied
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + + + +
SpezifikationenStatusKommentar
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Initial definition
+ +

Browser Kompabilität

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}{{CompatGeckoDesktop("1.0")}}
+ {{CompatNo}} {{CompatGeckoDesktop("22.0")}}[1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{CompatGeckoMobile("1.0")}}
+ {{CompatNo}} {{CompatGeckoMobile("22.0")}}[1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
+
+ +

[1] The method is still available from within chrome scripts.

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html new file mode 100644 index 0000000000..9977702331 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html @@ -0,0 +1,103 @@ +--- +title: Map.prototype[@@iterator]() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +--- +
{{JSRef}}
+ +

Der initialewert der @@iterator Eigenschaft enthält das selbe Funktionsobjekt wie der Wert in der {{jsxref("Map.prototype.entries()", "entries")}} Methode.

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

Syntax

+ +
myMap[Symbol.iterator]
+ +

Rückgabewert

+ +

Die iterator Funktion von map ist im Standardfall die {{jsxref("Map.prototype.entries()", "entries()")}} Funktion.

+ +

Beispiele

+ +

Einsatz von [@@iterator]()

+ +
const myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+const mapIter = myMap[Symbol.iterator]();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Einsatz von [@@iterator]() mit for..of

+ +
const myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+for (const entry of myMap) {
+  console.log(entry);
+}
+// ["0", "foo"]
+// [1, "bar"]
+// [{}, "baz"]
+
+for (const [key, value] of myMap) {
+  console.log(`${key}: ${value}`);
+}
+// 0: foo
+// 1: bar
+// [Object]: baz
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/@@species/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/@@species/index.html new file mode 100644 index 0000000000..52d7532777 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/@@species/index.html @@ -0,0 +1,73 @@ +--- +title: get Map[@@species] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species +--- +
{{JSRef}}
+ +

Die Map[@@species] Zugriffseigenschaft gibt den Map Konstruktor zurück.

+ +

Syntax

+ +
Map[Symbol.species]
+
+ +

Beschreibung

+ +

Die species Zugriffseigenschaft gibt den Standard-Konstruktor für Map Objekte zurück. Konstruktoren von Unterklassen überschreiben diese Eigenschaft manchmal, um die Konstruktorzuweisung zu ändern.

+ +

Beispiele

+ +

Die species Eigenschaft gibt die Standard-Konstruktorfunktion, welches der Map Konstruktor von Map Objekten ist:

+ +
Map[Symbol.species]; // function Map()
+ +

In einem abgeleiteten Collection Objekt (z. B. eine Benutzerdifinierte Map MyMap) ist der species von MyMap der MyMap Konstruktor. Manchmal, wenn dieser Überschrieben wird das Eltern Map Objekt in der abgeleiteten Klassenmethode verwenden:

+ +
class MyMap extends Map {
+  // Overwrite MyMap species to the parent Map constructor
+  static get [Symbol.species]() { return Map; }
+}
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ +
+ + +

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

+
+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html new file mode 100644 index 0000000000..81a3688e37 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,59 @@ +--- +title: Map.prototype[@@toStringTag] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +--- +
{{JSRef}}
+ +

Die Map[@@toStringTag] Eigenschaft hat den initialen Wert "Map".

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

Syntax

+ +
Map[Symbol.toStringTag]
+ +

Beispiele

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

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..081e571b21 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

Die clear() Methode entfernt alle Elemente von einem Map Objekt.

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

Syntax

+ +
myMap.clear();
+ +

Rückgabewert

+ +

{{jsxref("undefined")}}.

+ +

Beispiele

+ +

Einsatz der clear Methode

+ +
var myMap = new Map();
+myMap.set('bar', 'baz');
+myMap.set(1, 'foo');
+
+myMap.size;       // 2
+myMap.has('bar'); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has('bar')  // false
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..5215b5e990 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,74 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

Die delete() Methode entfernt das Element mit eine bestimmten Schlüssel von einem Map Objekt.

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

Syntax

+ +
myMap.delete(key);
+ +

Parameter

+ +
+
key
+
Der Schlüssel des Element, welches aus dem Map Objekt entfernt wird.
+
+ +

Rückgabewert

+ +

Gibt true zurück, wenn ein Element in der Map existiert und gelöscht wird, oder false wenn kein Element existiert.

+ +

Beispiele

+ +

Einsatz der delete Methode

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.delete('bar'); // Returns true. Successfully removed.
+myMap.has('bar');    // Returns false. The "bar" element is no longer present.
+
+ +

Spezifikationen

+ + + + + + + + + + + + + +
Spezifikation
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..b63d954920 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,79 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

Die entries() Methode gibt ein neues Iterator Objekt mit allen [Schlüssel, Wert] Paaren von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.

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

Syntax

+ +
myMap.entries()
+ +

Rückgabewert

+ +

Ein neues {{jsxref("Map")}} Iterator Objekt.

+ +

Beispiele

+ +

Einsatz von entries()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..36bdab6612 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,105 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

Die forEach() Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt in der Einfügereihenfolge aus.

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

Syntax

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

Parameter

+ +
+
callback
+
Funktion, die für jedes Schlüssel/Werte-Paar aufgerufen wird.
+
thisArg
+
Wert, der bei der Ausführung der callback-Funktion als this genutzt wird.
+
+ +

Rückgabewert

+ +

{{jsxref("undefined")}}.

+ +

Beschreibung

+ +

Die forEach Methode ruft die übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt aus. Die callback Funktion wird nicht aufgerufen, wenn der Schlüssel gelöscht wurde. Sie wird aber aufgerufen, wenn der aktuelle Wert undefined ist.

+ +

Die callback Funktion wird mit drei Parametern aufgerufen:

+ + + +

Wenn der thisArg-Parameter an forEach übergeben wird, wird er auch an die callback-Funktion als deren this Wert weitergegeben.  Andernfalls wird dafür undefined genutzt.  Der this-Wert, der in der callback-Funktion wahrgenommen wird, ist festgelegt durch die generellen Regeln für die Nutzung von this in einer Funktion.

+ +

Jeder Wert wird einmal besucht, mit Außnahme von Fällen, in denen ein Wert glöscht und neu hinzugefügt wird, bevor forEach fertig ist. Die callback Funktion wird nicht für Wert aufgerufen, die vorher gelöscht wurden. Neue Werte, die vor der Beendigung von forEach hinzugefügt werden, werden berücksichtigt.

+ +

Die forEach Methode ruft callback für jedes Element in dem Map Objekt aus.  forEach gibt keinen Wert zurück.

+ +

Beispiele

+ +

Ausgabe der Inhalte eines Map Objekts

+ +

Der folgende Code gibt für jedes Element in der Map eine Nachricht in der Konsole aus.

+ +
function logMapElements(value, key, map) {
+    console.log(`m[${key}] = ${value}`);
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
+// logs:
+// "m[foo] = 3"
+// "m[bar] = [object Object]"
+// "m[baz] = undefined"
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..5efb9e089f --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,81 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

Die get() Methode gibt eine Spezielles Element aus einem Map Objekt zurück.

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

Syntax

+ +
myMap.get(schlüssel);
+ +

Parameter

+ +
+
schlüssel
+
Der Schlüssel eines Elements, welches aus der Map zurückgegeben wird.
+
+ +

Rückgabewert

+ +

Gibt das Element zurück, welches zu dem Schlüssel gehört oder undefined, wenn kein Schlüssel in dem Map Objekt vorhanden ist.

+ +

Beispiele

+ +

Einsatz der get Methode

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');  // Returns "foo".
+myMap.get('baz');  // Returns undefined.
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

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

Die has() Methode gibt einen boolean zurück, welcher angibt, ob ein spezieller Schlüssel vorhanden ist oder nicht.

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

Syntax

+ +
myMap.has(schlüssel);
+ +

Parameter

+ +
+
schlüssel
+
Der Schlüssel, auf dessen Präsenz in dem Map Objekt geprüft wird.
+
+ +

Return value

+ +
+
Boolean
+
Gibt true zurück, wenn ein Element mit Schlüssel in dem Map Objekt existiert, andernfalls false.
+
+ +

Beispiele

+ +

Einsatz der has Methode

+ +
var myMap = new Map();
+myMap.set('bar', "foo");
+
+myMap.has('bar');  // returns true
+myMap.has('baz');  // returns false
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..b233ab6320 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,208 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +
Das Map Objekt ist eine einfache Schlüssel/Wert Zuordnung. Jeder Wert (Sowohl Objekte, als auch  {{Glossary("Primitive", "primitive Datentypen")}}) kann als Schlüssel/Wert verwendet werden.
+ +

Syntax

+ +
new Map([iterable])
+ +

Parameter

+ +
+
iterable
+
+

Der Parameter iterable ist ein Array oder anderes iterierbares Objekt, dessen Elemente Schlüssel-Wert Paare (2-Element Arrays) sind. Jedes Schlüssel-Wert Paar wird der neuen Map hinzugefügt.

+
+
+ +

Beschreibung

+ +

Ein Map Object iteriert in der Reihenfolge des Einfügens über seine Elemente — eine {{jsxref("Statements/for...of", "for...of")}} Schleife gibt ein Array mit [key, value] für jede Iteration zurück.

+ +

Es ist festzuhalten, dass eine Map, bestehend aus objects, insbesondere ein "dictionary of dictionaries", nur nach der Einfügereihenfolge angelegt wird, die zufällig und ungeordnet ist.

+ +

Schlüsselvergleich

+ +

Der Schlüsselvergleich basiert auf dem "gleicher-Wert" Algorithmus: NaN wird als gleich mit einer anderen NaN angesehen (trotz dem, dass NaN !== NaN) und alle anderen Werte müssen typ- und wert identisch, wie beim === Operator, sein. In der aktuellen ECMAScript Spezifikation werden -0 und +0 als gleich behandelt, auch wenn dies in früheren Entwürfen anders war. Details dazu sind der Tabelle browser compatibility zu entnehmen. 

+ +

Objects und Maps im Vergleich

+ +

{{jsxref("Object", "Objects")}} und Maps haben einige gemeinsame Eigenschaften. In beiden lassen sich Schlüssel auf Werte setzen, diese Werte wiederfinden, Schlüssel löschen und herausfinden, ob etwas unter einem bestimmten Schlüssel gespeichert ist. Aus diesem Grund (und weil es keine spracheigenen Alternativen gab) wurden früher Objects als Maps benutzt. Doch es gibt bedeutende Unterschiede zwischen diesen beiden Strukturen, die es in verschiedenen Fällen zu beachten gilt:

+ + + +

Eigenschaften

+ +
+
Map.length
+
Der Wert von length beträgt 0.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
Die Konstruktor-Funktion, zum Erzeugen abgeleiteter Objekte.
+
{{jsxref("Map.prototype")}}
+
Repräsentiert den Prototyp für den Map Konstruktor. Erlaubt das Hinzufügen von Eigenschaften zu allen Map Objekten.
+
+ +

Map Instanzen

+ +

Alle Map Instanzen erben von {{jsxref("Map.prototype")}}.

+ +

Eigenschaften

+ +

{{page('/de/Web/JavaScript/Reference/Global_Objects/Map/prototype','Eigenschaften')}}

+ +

Methoden

+ +

{{page('/de/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methoden')}}

+ +

Beispiele

+ +

Einsatz vom Map Objekt

+ +
var myMap = new Map();
+
+var keyString = "ein string",
+    keyObj = {},
+    keyFunc = function () {};
+
+// setting the values
+myMap.set(keyString, "value associated with 'ein string'");
+myMap.set(keyObj, "value associated with keyObj");
+myMap.set(keyFunc, "value associated with keyFunc");
+
+myMap.size; // 3
+
+// getting the values
+myMap.get(keyString);    // "value associated with 'ein string'"
+myMap.get(keyObj);       // "value associated with keyObj"
+myMap.get(keyFunc);      // "value associated with keyFunc"
+
+myMap.get("ein string");   // "value associated with 'ein string'"
+                         // because keyString === 'ein string'
+myMap.get({});           // undefined, because keyObj !== {}
+myMap.get(function() {}) // undefined, because keyFunc !== function () {}
+
+ +

Benutzung von NaN als Map Schlüssel

+ +

NaN kann auch als Schlüssel benutzt werden. Auch wenn jede NaN nicht gleich zu sich selbst ist (NaN !== NaN is true) funktioniert das folgende Beispiel, da NaNs ununterscheidbar von jeder anderen ist:

+ +
var myMap = new Map();
+myMap.set(NaN, "not a number");
+
+myMap.get(NaN); // "not a number"
+
+var otherNaN = Number("foo");
+myMap.get(otherNaN); // "not a number"
+
+ +

Iterieren über Maps mit for..of

+ +

Über Maps kann mit der for..of Schleife iteriert werden:

+ +
var myMap = new Map();
+myMap.set(0, "zero");
+myMap.set(1, "one");
+for (var [key, value] of myMap) {
+  console.log(key + " = " + value);
+}
+// 0 = zero
+// 1 = one
+
+for (var key of myMap.keys()) {
+  console.log(key);
+}
+// 0
+// 1
+
+for (var value of myMap.values()) {
+  console.log(value);
+}
+// zero
+// one
+
+for (var [key, value] of myMap.entries()) {
+  console.log(key + " = " + value);
+}
+// 0 = zero
+// 1 = one
+
+ +

Integration von Maps mit forEach()

+ +

Über Maps kann mit der forEach() method iteriert werden:

+ +
myMap.forEach(function(value, key) {
+  console.log(key + " = " + value);
+}, myMap)
+// Will show 2 logs; first with "0 = zero" and second with "1 = one"
+
+ +

Relation mit Array Objekten

+ +
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
+
+// Use the regular Map constructor to transform a 2D key-value Array into a map
+var myMap = new Map(kvArray);
+
+myMap.get('key1'); // returns "value1"
+
+// Use the Array.from function to transform a map into a 2D key-value Array
+console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray
+
+// Or use the keys or values iterators and convert them to an array
+console.log(Array.from(myMap.keys())); // Will show ["key1", "key2"]
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..8f1f586887 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,70 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

Die Methode keys() gibt ein neues Iterator Objekt zurück, das die Schlüssel für alle Elemente des Map Objekts in der Reihenfolge des Einfügens enthält.

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

Syntax

+ +
myMap.keys()
+ +

Rückgabewert

+ +

Ein neues {{jsxref("Map")}} Iterator-Objekt.

+ +

Beispiele

+ +

Verwendung von keys()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

Spezifikationen

+ + + + + + + + + + +
Spezifikation
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..42a4567ea5 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,97 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

Die set() Methode fügt ein ELement mit einem spezifischen schlüssel und wert zu einem Map Objekt hinzu oder aktualisiert es.

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

Syntax

+ +
myMap.set(schlüssel, wert);
+ +

Parameter

+ +
+
schlüssel
+
Der Schlüssel des Elementes, welches zu dem Map Objekt hinzugefügt wird.
+
wert
+
Der Wert des Elementes, welches zu dem Map Objekt hinzugefügt wird.
+
+ +

Rückgabewert

+ +

Das Map Objekt.

+ +

Beispiele

+ +

Einsatz der set Methode

+ +
var myMap = new Map();
+
+// Fügt ein neues Element hinzu
+myMap.set('bar', 'foo');
+myMap.set(1, 'foobar');
+
+// Aktualisiert ein Element
+myMap.set('bar', 'baz');
+
+ +

Einsatz der set Methode mit Verkettung

+ +

Seit die set() Methode das selbe Map Objekt zurück gibt, kann die Methode wie folgt verkettet aufgerufen werden.

+ +
// Fügt neue Element mit verketteten Aufruf hinzu.
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+
+
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..7d27071a44 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,68 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

Die size Zugriffseigenschaft gibt die Anzahl der Elemente in einem {{jsxref("Map")}} Objekt zurück.

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

Beschreibung

+ +

Der Wert von size ist eine ganze Zahl, die angibt, wie viele Einträge ein Map Objekt hat. Die set-Zugriffsfunktion für size ist undefined; diese Eigenschaft kann nicht geändert werden.

+ +

Beispiele

+ +

Einsatz von size

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

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/de/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..07eb723535 --- /dev/null +++ b/files/de/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

Die values() Methode gibt ein neues Iterator Objekt mit allen Werten aller Elemente des Map Objektes in Einfügereihenfolge zurück.

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

Syntax

+ +
myMap.values()
+ +

Rückgabewert

+ +

Ein neues {{jsxref("Map")}} Iterator Objekt.

+ +

Beispiele

+ +

Einsatz von values()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

Spezifikationen

+ + + + + + + + + + + + + + + + + + + +
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

Browserkompatibilität

+ + + +

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

+ +

Siehe auch

+ + diff --git a/files/de/web/api/node/setuserdata/index.html b/files/de/web/api/node/setuserdata/index.html deleted file mode 100644 index 7c4c714d01..0000000000 --- a/files/de/web/api/node/setuserdata/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: Node.setUserData() -slug: Web/API/Node/setUserData -translation_of: Web/API/Node/setUserData ---- -
{{APIRef("DOM")}}{{obsolete_header}}
- -

Die Methode Node.setUserData()erlaubt es dem Benutzer Daten dem Element hinzuzufügen (oder löschen), ohne dabei die DOM zu modifizieren. Beachte dabei, dass die Daten durch das Nutzen von {{domxref("Node.importNode")}}, {{domxref("Node.cloneNode()")}} und {{domxref("Node.renameNode()")}} nicht mitgegeben werden kann (jedoch kann {{domxref("Node.adoptNode")}} die Information behalten), und bei Vergleichstest mit {{domxref("Node.isEqualNode()")}} werden die Daten nicht berücksichtigt.

- -

This method offers the convenience of associating data with specific nodes without needing to alter the structure of a document and in a standard fashion, but it also means that extra steps may need to be taken if one wishes to serialize the information or include the information upon clone, import, or rename operations.

- -
-

The Node.getUserData and {{domxref("Node.setUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

-
- -

Syntax

- -
var prevUserData = someNode.setUserData(userKey, userData, handler);
- -

Parameters

- - - -

Beispiel

- -
var d = document.implementation.createDocument('', 'test', null);
-d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
-console.log(d.documentElement.getUserData('key')); // 15
-var e = document.importNode(d.documentElement, true); // causes handler to be called
-console.log(e.getUserData('key')); // null since user data is not copied
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - - - -
SpezifikationenStatusKommentar
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Initial definition
- -

Browser Kompabilität

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}{{CompatGeckoDesktop("1.0")}}
- {{CompatNo}} {{CompatGeckoDesktop("22.0")}}[1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
-
- -
- - - - - - - - - - - - - - - - - - - -
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{CompatGeckoMobile("1.0")}}
- {{CompatNo}} {{CompatGeckoMobile("22.0")}}[1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
-
- -

[1] The method is still available from within chrome scripts.

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/de/web/javascript/reference/global_objects/map/@@iterator/index.html deleted file mode 100644 index 8f480772d1..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/@@iterator/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: 'Map.prototype[@@iterator]()' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator ---- -
{{JSRef}}
- -

Der initialewert der @@iterator Eigenschaft enthält das selbe Funktionsobjekt wie der Wert in der {{jsxref("Map.prototype.entries()", "entries")}} Methode.

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

Syntax

- -
myMap[Symbol.iterator]
- -

Rückgabewert

- -

Die iterator Funktion von map ist im Standardfall die {{jsxref("Map.prototype.entries()", "entries()")}} Funktion.

- -

Beispiele

- -

Einsatz von [@@iterator]()

- -
const myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-const mapIter = myMap[Symbol.iterator]();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Einsatz von [@@iterator]() mit for..of

- -
const myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-for (const entry of myMap) {
-  console.log(entry);
-}
-// ["0", "foo"]
-// [1, "bar"]
-// [{}, "baz"]
-
-for (const [key, value] of myMap) {
-  console.log(`${key}: ${value}`);
-}
-// 0: foo
-// 1: bar
-// [Object]: baz
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/@@species/index.html b/files/de/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index 8dc72de6bc..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: 'get Map[@@species]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@species -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -
{{JSRef}}
- -

Die Map[@@species] Zugriffseigenschaft gibt den Map Konstruktor zurück.

- -

Syntax

- -
Map[Symbol.species]
-
- -

Beschreibung

- -

Die species Zugriffseigenschaft gibt den Standard-Konstruktor für Map Objekte zurück. Konstruktoren von Unterklassen überschreiben diese Eigenschaft manchmal, um die Konstruktorzuweisung zu ändern.

- -

Beispiele

- -

Die species Eigenschaft gibt die Standard-Konstruktorfunktion, welches der Map Konstruktor von Map Objekten ist:

- -
Map[Symbol.species]; // function Map()
- -

In einem abgeleiteten Collection Objekt (z. B. eine Benutzerdifinierte Map MyMap) ist der species von MyMap der MyMap Konstruktor. Manchmal, wenn dieser Überschrieben wird das Eltern Map Objekt in der abgeleiteten Klassenmethode verwenden:

- -
class MyMap extends Map {
-  // Overwrite MyMap species to the parent Map constructor
-  static get [Symbol.species]() { return Map; }
-}
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- -
- - -

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

-
- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/de/web/javascript/reference/global_objects/map/@@tostringtag/index.html deleted file mode 100644 index 50d1515963..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: 'Map.prototype[@@toStringTag]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag ---- -
{{JSRef}}
- -

Die Map[@@toStringTag] Eigenschaft hat den initialen Wert "Map".

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

Syntax

- -
Map[Symbol.toStringTag]
- -

Beispiele

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

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

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

Die clear() Methode entfernt alle Elemente von einem Map Objekt.

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

Syntax

- -
myMap.clear();
- -

Rückgabewert

- -

{{jsxref("undefined")}}.

- -

Beispiele

- -

Einsatz der clear Methode

- -
var myMap = new Map();
-myMap.set('bar', 'baz');
-myMap.set(1, 'foo');
-
-myMap.size;       // 2
-myMap.has('bar'); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has('bar')  // false
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/delete/index.html b/files/de/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 40f38a6931..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

Die delete() Methode entfernt das Element mit eine bestimmten Schlüssel von einem Map Objekt.

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

Syntax

- -
myMap.delete(key);
- -

Parameter

- -
-
key
-
Der Schlüssel des Element, welches aus dem Map Objekt entfernt wird.
-
- -

Rückgabewert

- -

Gibt true zurück, wenn ein Element in der Map existiert und gelöscht wird, oder false wenn kein Element existiert.

- -

Beispiele

- -

Einsatz der delete Methode

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.delete('bar'); // Returns true. Successfully removed.
-myMap.has('bar');    // Returns false. The "bar" element is no longer present.
-
- -

Spezifikationen

- - - - - - - - - - - - - -
Spezifikation
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/entries/index.html b/files/de/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index 018cd8088a..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

Die entries() Methode gibt ein neues Iterator Objekt mit allen [Schlüssel, Wert] Paaren von jedem Element in dem Map Objekt in Einfügereihenfolge zurück.

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

Syntax

- -
myMap.entries()
- -

Rückgabewert

- -

Ein neues {{jsxref("Map")}} Iterator Objekt.

- -

Beispiele

- -

Einsatz von entries()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/foreach/index.html b/files/de/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index 017fa9b069..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

Die forEach() Methode führt eine übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt in der Einfügereihenfolge aus.

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

Syntax

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

Parameter

- -
-
callback
-
Funktion, die für jedes Schlüssel/Werte-Paar aufgerufen wird.
-
thisArg
-
Wert, der bei der Ausführung der callback-Funktion als this genutzt wird.
-
- -

Rückgabewert

- -

{{jsxref("undefined")}}.

- -

Beschreibung

- -

Die forEach Methode ruft die übergebene Funktion für jedes Schlüssel/Wert Paar in dem Map Objekt aus. Die callback Funktion wird nicht aufgerufen, wenn der Schlüssel gelöscht wurde. Sie wird aber aufgerufen, wenn der aktuelle Wert undefined ist.

- -

Die callback Funktion wird mit drei Parametern aufgerufen:

- - - -

Wenn der thisArg-Parameter an forEach übergeben wird, wird er auch an die callback-Funktion als deren this Wert weitergegeben.  Andernfalls wird dafür undefined genutzt.  Der this-Wert, der in der callback-Funktion wahrgenommen wird, ist festgelegt durch die generellen Regeln für die Nutzung von this in einer Funktion.

- -

Jeder Wert wird einmal besucht, mit Außnahme von Fällen, in denen ein Wert glöscht und neu hinzugefügt wird, bevor forEach fertig ist. Die callback Funktion wird nicht für Wert aufgerufen, die vorher gelöscht wurden. Neue Werte, die vor der Beendigung von forEach hinzugefügt werden, werden berücksichtigt.

- -

Die forEach Methode ruft callback für jedes Element in dem Map Objekt aus.  forEach gibt keinen Wert zurück.

- -

Beispiele

- -

Ausgabe der Inhalte eines Map Objekts

- -

Der folgende Code gibt für jedes Element in der Map eine Nachricht in der Konsole aus.

- -
function logMapElements(value, key, map) {
-    console.log(`m[${key}] = ${value}`);
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
-// logs:
-// "m[foo] = 3"
-// "m[bar] = [object Object]"
-// "m[baz] = undefined"
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/get/index.html b/files/de/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index c178c59f0b..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

Die get() Methode gibt eine Spezielles Element aus einem Map Objekt zurück.

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

Syntax

- -
myMap.get(schlüssel);
- -

Parameter

- -
-
schlüssel
-
Der Schlüssel eines Elements, welches aus der Map zurückgegeben wird.
-
- -

Rückgabewert

- -

Gibt das Element zurück, welches zu dem Schlüssel gehört oder undefined, wenn kein Schlüssel in dem Map Objekt vorhanden ist.

- -

Beispiele

- -

Einsatz der get Methode

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');  // Returns "foo".
-myMap.get('baz');  // Returns undefined.
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/has/index.html b/files/de/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index ea4df56c27..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

Die has() Methode gibt einen boolean zurück, welcher angibt, ob ein spezieller Schlüssel vorhanden ist oder nicht.

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

Syntax

- -
myMap.has(schlüssel);
- -

Parameter

- -
-
schlüssel
-
Der Schlüssel, auf dessen Präsenz in dem Map Objekt geprüft wird.
-
- -

Return value

- -
-
Boolean
-
Gibt true zurück, wenn ein Element mit Schlüssel in dem Map Objekt existiert, andernfalls false.
-
- -

Beispiele

- -

Einsatz der has Methode

- -
var myMap = new Map();
-myMap.set('bar', "foo");
-
-myMap.has('bar');  // returns true
-myMap.has('baz');  // returns false
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/index.html b/files/de/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 3cfa11c840..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,207 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -
Das Map Objekt ist eine einfache Schlüssel/Wert Zuordnung. Jeder Wert (Sowohl Objekte, als auch  {{Glossary("Primitive", "primitive Datentypen")}}) kann als Schlüssel/Wert verwendet werden.
- -

Syntax

- -
new Map([iterable])
- -

Parameter

- -
-
iterable
-
-

Der Parameter iterable ist ein Array oder anderes iterierbares Objekt, dessen Elemente Schlüssel-Wert Paare (2-Element Arrays) sind. Jedes Schlüssel-Wert Paar wird der neuen Map hinzugefügt.

-
-
- -

Beschreibung

- -

Ein Map Object iteriert in der Reihenfolge des Einfügens über seine Elemente — eine {{jsxref("Statements/for...of", "for...of")}} Schleife gibt ein Array mit [key, value] für jede Iteration zurück.

- -

Es ist festzuhalten, dass eine Map, bestehend aus objects, insbesondere ein "dictionary of dictionaries", nur nach der Einfügereihenfolge angelegt wird, die zufällig und ungeordnet ist.

- -

Schlüsselvergleich

- -

Der Schlüsselvergleich basiert auf dem "gleicher-Wert" Algorithmus: NaN wird als gleich mit einer anderen NaN angesehen (trotz dem, dass NaN !== NaN) und alle anderen Werte müssen typ- und wert identisch, wie beim === Operator, sein. In der aktuellen ECMAScript Spezifikation werden -0 und +0 als gleich behandelt, auch wenn dies in früheren Entwürfen anders war. Details dazu sind der Tabelle browser compatibility zu entnehmen. 

- -

Objects und Maps im Vergleich

- -

{{jsxref("Object", "Objects")}} und Maps haben einige gemeinsame Eigenschaften. In beiden lassen sich Schlüssel auf Werte setzen, diese Werte wiederfinden, Schlüssel löschen und herausfinden, ob etwas unter einem bestimmten Schlüssel gespeichert ist. Aus diesem Grund (und weil es keine spracheigenen Alternativen gab) wurden früher Objects als Maps benutzt. Doch es gibt bedeutende Unterschiede zwischen diesen beiden Strukturen, die es in verschiedenen Fällen zu beachten gilt:

- - - -

Eigenschaften

- -
-
Map.length
-
Der Wert von length beträgt 0.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
Die Konstruktor-Funktion, zum Erzeugen abgeleiteter Objekte.
-
{{jsxref("Map.prototype")}}
-
Repräsentiert den Prototyp für den Map Konstruktor. Erlaubt das Hinzufügen von Eigenschaften zu allen Map Objekten.
-
- -

Map Instanzen

- -

Alle Map Instanzen erben von {{jsxref("Map.prototype")}}.

- -

Eigenschaften

- -

{{page('/de/Web/JavaScript/Reference/Global_Objects/Map/prototype','Eigenschaften')}}

- -

Methoden

- -

{{page('/de/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methoden')}}

- -

Beispiele

- -

Einsatz vom Map Objekt

- -
var myMap = new Map();
-
-var keyString = "ein string",
-    keyObj = {},
-    keyFunc = function () {};
-
-// setting the values
-myMap.set(keyString, "value associated with 'ein string'");
-myMap.set(keyObj, "value associated with keyObj");
-myMap.set(keyFunc, "value associated with keyFunc");
-
-myMap.size; // 3
-
-// getting the values
-myMap.get(keyString);    // "value associated with 'ein string'"
-myMap.get(keyObj);       // "value associated with keyObj"
-myMap.get(keyFunc);      // "value associated with keyFunc"
-
-myMap.get("ein string");   // "value associated with 'ein string'"
-                         // because keyString === 'ein string'
-myMap.get({});           // undefined, because keyObj !== {}
-myMap.get(function() {}) // undefined, because keyFunc !== function () {}
-
- -

Benutzung von NaN als Map Schlüssel

- -

NaN kann auch als Schlüssel benutzt werden. Auch wenn jede NaN nicht gleich zu sich selbst ist (NaN !== NaN is true) funktioniert das folgende Beispiel, da NaNs ununterscheidbar von jeder anderen ist:

- -
var myMap = new Map();
-myMap.set(NaN, "not a number");
-
-myMap.get(NaN); // "not a number"
-
-var otherNaN = Number("foo");
-myMap.get(otherNaN); // "not a number"
-
- -

Iterieren über Maps mit for..of

- -

Über Maps kann mit der for..of Schleife iteriert werden:

- -
var myMap = new Map();
-myMap.set(0, "zero");
-myMap.set(1, "one");
-for (var [key, value] of myMap) {
-  console.log(key + " = " + value);
-}
-// 0 = zero
-// 1 = one
-
-for (var key of myMap.keys()) {
-  console.log(key);
-}
-// 0
-// 1
-
-for (var value of myMap.values()) {
-  console.log(value);
-}
-// zero
-// one
-
-for (var [key, value] of myMap.entries()) {
-  console.log(key + " = " + value);
-}
-// 0 = zero
-// 1 = one
-
- -

Integration von Maps mit forEach()

- -

Über Maps kann mit der forEach() method iteriert werden:

- -
myMap.forEach(function(value, key) {
-  console.log(key + " = " + value);
-}, myMap)
-// Will show 2 logs; first with "0 = zero" and second with "1 = one"
-
- -

Relation mit Array Objekten

- -
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
-
-// Use the regular Map constructor to transform a 2D key-value Array into a map
-var myMap = new Map(kvArray);
-
-myMap.get('key1'); // returns "value1"
-
-// Use the Array.from function to transform a map into a 2D key-value Array
-console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray
-
-// Or use the keys or values iterators and convert them to an array
-console.log(Array.from(myMap.keys())); // Will show ["key1", "key2"]
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/keys/index.html b/files/de/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index 0f8187752b..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{JSRef}}
- -

Die Methode keys() gibt ein neues Iterator Objekt zurück, das die Schlüssel für alle Elemente des Map Objekts in der Reihenfolge des Einfügens enthält.

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

Syntax

- -
myMap.keys()
- -

Rückgabewert

- -

Ein neues {{jsxref("Map")}} Iterator-Objekt.

- -

Beispiele

- -

Verwendung von keys()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

Spezifikationen

- - - - - - - - - - -
Spezifikation
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/set/index.html b/files/de/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index dd675fab69..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

Die set() Methode fügt ein ELement mit einem spezifischen schlüssel und wert zu einem Map Objekt hinzu oder aktualisiert es.

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

Syntax

- -
myMap.set(schlüssel, wert);
- -

Parameter

- -
-
schlüssel
-
Der Schlüssel des Elementes, welches zu dem Map Objekt hinzugefügt wird.
-
wert
-
Der Wert des Elementes, welches zu dem Map Objekt hinzugefügt wird.
-
- -

Rückgabewert

- -

Das Map Objekt.

- -

Beispiele

- -

Einsatz der set Methode

- -
var myMap = new Map();
-
-// Fügt ein neues Element hinzu
-myMap.set('bar', 'foo');
-myMap.set(1, 'foobar');
-
-// Aktualisiert ein Element
-myMap.set('bar', 'baz');
-
- -

Einsatz der set Methode mit Verkettung

- -

Seit die set() Methode das selbe Map Objekt zurück gibt, kann die Methode wie folgt verkettet aufgerufen werden.

- -
// Fügt neue Element mit verketteten Aufruf hinzu.
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
-
-
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/size/index.html b/files/de/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 3f859dcde5..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

Die size Zugriffseigenschaft gibt die Anzahl der Elemente in einem {{jsxref("Map")}} Objekt zurück.

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

Beschreibung

- -

Der Wert von size ist eine ganze Zahl, die angibt, wie viele Einträge ein Map Objekt hat. Die set-Zugriffsfunktion für size ist undefined; diese Eigenschaft kann nicht geändert werden.

- -

Beispiele

- -

Einsatz von size

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

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/de/web/javascript/reference/global_objects/map/values/index.html b/files/de/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 3cbe8dd064..0000000000 --- a/files/de/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
{{JSRef}}
- -

Die values() Methode gibt ein neues Iterator Objekt mit allen Werten aller Elemente des Map Objektes in Einfügereihenfolge zurück.

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

Syntax

- -
myMap.values()
- -

Rückgabewert

- -

Ein neues {{jsxref("Map")}} Iterator Objekt.

- -

Beispiele

- -

Einsatz von values()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

Spezifikationen

- - - - - - - - - - - - - - - - - - - -
SpezifikationStatusKommentar
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initiale Definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Browserkompatibilität

- - - -

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

- -

Siehe auch

- - diff --git a/files/es/_redirects.txt b/files/es/_redirects.txt index a84d00f2b6..4a1c6a4158 100644 --- a/files/es/_redirects.txt +++ b/files/es/_redirects.txt @@ -2407,6 +2407,17 @@ /es/docs/Web/JavaScript/Reference/Errors/Indicador_regexp_no-val /es/docs/Web/JavaScript/Reference/Errors/Bad_regexp_flag /es/docs/Web/JavaScript/Reference/Errors/Strict_y_parámetros_complejos /es/docs/Web/JavaScript/Reference/Errors/Strict_Non_Simple_Params /es/docs/Web/JavaScript/Reference/Errors/caracter_ilegal /es/docs/Web/JavaScript/Reference/Errors/Illegal_character +/es/docs/Web/JavaScript/Reference/Global_Objects/Map /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/get /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/has /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/set /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/size /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/es/docs/Web/JavaScript/Reference/Global_Objects/Map/values /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler/getOwnPropertyDescriptor /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/getOwnPropertyDescriptor /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler/set /es/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/set @@ -2564,18 +2575,18 @@ /es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON /es/docs/Web/JavaScript/Reference/Global_Objects/JSON /es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON/parse /es/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse /es/docs/Web/JavaScript/Referencia/Objetos_globales/JSON/stringify /es/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map /es/docs/Web/JavaScript/Reference/Global_Objects/Map -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/clear /es/docs/Web/JavaScript/Reference/Global_Objects/Map/clear -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/delete /es/docs/Web/JavaScript/Reference/Global_Objects/Map/delete -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/entries /es/docs/Web/JavaScript/Reference/Global_Objects/Map/entries -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/forEach /es/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/get /es/docs/Web/JavaScript/Reference/Global_Objects/Map/get -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/has /es/docs/Web/JavaScript/Reference/Global_Objects/Map/has -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/keys /es/docs/Web/JavaScript/Reference/Global_Objects/Map/keys +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/clear /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/delete /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/entries /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/forEach /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/get /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/has /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/keys /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/prototype /es/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/set /es/docs/Web/JavaScript/Reference/Global_Objects/Map/set -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/size /es/docs/Web/JavaScript/Reference/Global_Objects/Map/size -/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/values /es/docs/Web/JavaScript/Reference/Global_Objects/Map/values +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/set /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/size /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/values /es/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /es/docs/Web/JavaScript/Referencia/Objetos_globales/Math /es/docs/Web/JavaScript/Reference/Global_Objects/Math /es/docs/Web/JavaScript/Referencia/Objetos_globales/Math/E /es/docs/Web/JavaScript/Reference/Global_Objects/Math/E /es/docs/Web/JavaScript/Referencia/Objetos_globales/Math/LN10 /es/docs/Web/JavaScript/Reference/Global_Objects/Math/LN10 diff --git a/files/es/_wikihistory.json b/files/es/_wikihistory.json index df4d50ebcf..e2d81fa61b 100644 --- a/files/es/_wikihistory.json +++ b/files/es/_wikihistory.json @@ -18559,90 +18559,6 @@ "carlosgctes" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:30:28.950Z", - "contributors": [ - "Almiqui", - "AntonioSalazar", - "SphinxKnight", - "Sebastiancbvz", - "vaavJSdev", - "timgivois", - "aeroxmotion", - "PepeAleu", - "xavier.gallofre", - "rn3w", - "Grijander81", - "GustavoFernandez", - "rec", - "Kouen", - "facundoj" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2019-03-23T22:33:57.332Z", - "contributors": [ - "Grijander81" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2019-06-22T21:43:58.894Z", - "contributors": [ - "gerardonavart", - "Grijander81" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2019-03-23T22:33:46.712Z", - "contributors": [ - "Grijander81" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T21:59:58.539Z", - "contributors": [ - "gerardonavart", - "PabloContreras", - "katuno1981" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T22:01:57.424Z", - "contributors": [ - "Marte", - "Sebastiancbvz" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T22:32:18.735Z", - "contributors": [ - "fredydeltoro" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2019-03-23T22:31:40.425Z", - "contributors": [ - "jesusfchavarro" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2019-03-23T22:28:28.999Z", - "contributors": [ - "guillermojmc" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2019-03-23T22:34:02.057Z", - "contributors": [ - "Grijander81" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-10-15T22:12:33.830Z", - "contributors": [ - "AlePerez92" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:17:08.782Z", "contributors": [ @@ -23634,6 +23550,90 @@ "humbertaco" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:30:28.950Z", + "contributors": [ + "Almiqui", + "AntonioSalazar", + "SphinxKnight", + "Sebastiancbvz", + "vaavJSdev", + "timgivois", + "aeroxmotion", + "PepeAleu", + "xavier.gallofre", + "rn3w", + "Grijander81", + "GustavoFernandez", + "rec", + "Kouen", + "facundoj" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2019-03-23T22:33:57.332Z", + "contributors": [ + "Grijander81" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2019-06-22T21:43:58.894Z", + "contributors": [ + "gerardonavart", + "Grijander81" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2019-03-23T22:33:46.712Z", + "contributors": [ + "Grijander81" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T21:59:58.539Z", + "contributors": [ + "gerardonavart", + "PabloContreras", + "katuno1981" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T22:01:57.424Z", + "contributors": [ + "Marte", + "Sebastiancbvz" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T22:32:18.735Z", + "contributors": [ + "fredydeltoro" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2019-03-23T22:31:40.425Z", + "contributors": [ + "jesusfchavarro" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2019-03-23T22:28:28.999Z", + "contributors": [ + "guillermojmc" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2019-03-23T22:34:02.057Z", + "contributors": [ + "Grijander81" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-10-15T22:12:33.830Z", + "contributors": [ + "AlePerez92" + ] + }, "orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator": { "modified": "2020-10-15T22:24:00.271Z", "contributors": [ diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..8d48f1081a --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,110 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

El método clear() elimina todos los elementos de un objeto Map.

+ +

Sintaxis

+ +
myMap.clear();
+ +

Ejemplos

+ +

Usando el método clear

+ +
var myMap = new Map();
+myMap.set("bar", "baz");
+myMap.set(1, "foo");
+
+myMap.size;       // 2
+myMap.has("bar"); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has("bar")  // false
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES6')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidad con navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico.38{{CompatGeckoDesktop("19.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico.{{CompatNo}}38{{CompatGeckoMobile("19.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..805d003686 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,115 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

El método delete() elimina el elemento especificado de un objeto Map.

+ +

Sintaxis

+ +
myMap.delete(clave);
+ +

Parámetros

+ +
+
clave
+
Requerido. La clave del elemento a eliminar del objeto Map.
+
+ +

Valor de retorno

+ +

Retorna true si el elemento existe en el objeto Map objecty fue eliminado, o false si el elemento no existe.

+ +

Ejemplo

+ +

Usando el método delete

+ +
var myMap = new Map();
+myMap.set("bar", "foo");
+
+myMap.delete("bar"); // Retorna true. Eliminado con éxito.
+myMap.has("bar");    // Retorna false. El elemento "bar" ya no está presente.
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES6')}}Definición inicial
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}}
+ +

Compatibilidad con navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
PrestaciónChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico38{{CompatGeckoDesktop("13.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
PrestaciónAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..9f63684690 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,110 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

El método entries() retorna un nuevo objeto Iterator que contiene los pares [clave, valor] para cada elemento en el objeto Map en orden de inserción.

+ +

Sintaxis

+ +
myMap.entries()
+ +

Ejemplos

+ +

Usando entries()

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES6')}}Definición
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidad con navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
PrestaciónChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
PrestaciónAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico.{{CompatNo}}38{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..ef7a8abb08 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,95 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

El método forEach() ejecuta una función por cada par clave / valor en el objeto Map, en orden de inserción.

+ +

Sintaxis

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

Parámetros

+ +
+
callback
+
Función ejecutada en cada elemento.
+
thisArg
+
Valor a usar por la funcion callback.
+
+ +

Valor de Retorno

+ +

{{jsxref("undefined")}}.

+ +

Descripción

+ +

El método forEach ejecuta la devolución de llamada (callback) proporcionada una vez para cada clave del mapa que realmente exista. No se invoca para las claves que se han eliminado. Sin embargo, se ejecuta para los valores que están presentes pero tienen el valor indefinido (undefined).

+ +

La función (callback) es invocada con 3 argumentos:

+ + + +

Si se provee un parámetro thisArg al método forEach, pasará al callback cuando sea invocado, para ser utilizado como su valor this. De otra manera, el valor undefined pasará para ser usado como su valor this. El valor this finalmente observable por el callback se determina de acuerdo a las reglas usuales para determinar la visibilidad de this por una función.

+ +

Cada valor es usado una vez, excepto en este caso cuando es eliminado y agregado de nuevo antes de que el forEach haya terminado. callback no es invocado para valores eliminados antes de que sean usados. 

+ +

El método forEach ejecuta la función callback una vez para cada elemento en el objeto Map; No se retornan valores.

+ +

Ejemplos

+ +

Imprimiendo el contenido de un objeto Map

+ +

El siguiente código imprime una línea por cada elemento en el objeto Map:

+ +
function logMapElements(value, key, map) {
+    console.log(`m[${key}] = ${value}`);
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
+// logs:
+// "m[foo] = 3"
+// "m[bar] = [object Object]"
+// "m[baz] = undefined"
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definición Inicial.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
+ +

Compatibilidad con navegadores

+ + + +

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

+ +

Véase también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..e61bf94935 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

El método get() devuelve un elemento específico de un objeto Map.

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

Sintaxis

+ +
miMapa.get(clave);
+ +

Parametros

+ +
+
clave
+
Requerido. La clave del elemento del objeto Map que queremos obtener.
+
+ +

Valor devuelto

+ +

Devuelve el elemento asociado a la clave indicada o undefined si la clave no ha sido encontrada en el objeto Map.

+ +

Ejemplos

+ +

Usando el método get

+ +
var miMapa = new Map();
+miMapa.set('bar', 'foo');
+
+miMapa.get('bar');  // Devuelve "foo".
+miMapa.get('baz');  // Devuelve undefined.
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstatusComentario
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

Compatiblidad con navegadores

+ + + +

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

+ +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..81253e3317 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,66 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

El método has() devuelve un booleano indicando si el elemento con la llave especificada existe o no.

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

Sintaxis

+ +
myMap.has(key)
+ +

Parameteros

+ +
+
key
+
La llave del elemento a probar si esta presente en el objeto Map.
+
+ +

Valor devuelto

+ +

true si el elemento con la llave especificada existe en el objeto Map; de lo contrario false.

+ +

Ejemplos

+ +

Usando has()

+ +
let myMap = new Map()
+myMap.set('bar', "foo")
+
+myMap.has('bar')   // returns true
+myMap.has('baz')   // returns false
+
+ +

Especificaciones

+ + + + + + + + + + +
Especificación
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}
+ +

Browser compatibility

+ + + +

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

+ +

See also

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..8fc502cf71 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,214 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef("Global_Objects", "Map")}}
+ +

Resumen

+ +

El objeto Map almacena pares clave/valor. Cualquier valor (tanto objetos como {{Glossary("Primitive", "valores primitivos")}}) pueden ser usados como clave o valor.

+ +

Sintaxis

+ +
new Map([iterable])
+
+ +

Parámetros

+ +
+
iterable
+
Iterable es un array o cualquier otro objeto iterable cuyos elementos son pares clave-valor (arrays de 2 elementos). Cada par clave-valor será agregado al nuevo Map.
+
+ +

Descripción

+ +

Un objeto Map puede iterar sobre sus elementos en orden de inserción. Un bucle for..of devolverá un array de [clave, valor] en cada iteración.

+ +

Cabe destacar que un Map el cual es un mapa de un objeto, especialmente un diccionario de diccionarios, solo se va a mapear en el orden de inserción del objeto — el cual es aleatorio y no ordenado.

+ +

Igualdad de claves

+ +

La igualdad de claves esta basada en el algoritmo "SameValueZero": NaN es considerado lo mismo que NaN (sin importar que NaN !== NaN) y todos los otros operadores son considerados iguales de acuerdo a la semantica del operador ===. En las primeras versiones de ECMAScript 6 -0 y +0 eran considarados distintos (even though -0 === +0), esto fue cambiado en posteriores versiones y ha sido implementado en Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) and a recent nightly Chrome.

+ +

Objetos y mapas comparados

+ +

Los {{jsxref("Object", "Objetos")}} son similares a los Maps en cuanto a que ambos permiten establecer claves a valores, recuperar dichos valores, eliminar claves, y detectar si existe algo almacenado en una clave determinada. Por esto, los Objects han sido usados históricamente como Maps; no obstante, hay diferencias importantes entre  Objects y Maps que hacen mejor usar un  Map  en la mayoría de casos.

+ + + +

Propiedades

+ +
+
Map.length
+
El valor de la propiedad de longitud es 0
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
La función constructor que se usa para crear objetos derivados.
+
{{jsxref("Map.prototype")}}
+
Representa el prototipo para el constructor de Map. Permite añadir propiedades a todos los objetos Map.
+
+ +

Instancias de Map

+ +

Todas las instancias de Map heredan de {{jsxref("Map.prototype")}}.

+ +

Propiedades

+ +

{{page('es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/prototype','Propiedades')}}

+ +

Métodos

+ +

{{page('es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/prototype','Métodos')}}

+ +

Ejemplos

+ +

Ejemplo: Usando el objeto Map

+ +
var miMapa = new Map();
+
+var claveObj = {},
+    claveFunc = function () {},
+    claveCadena = "una cadena";
+
+// asignando valores
+miMapa.set(claveCadena, "valor asociado con 'una cadena'");
+miMapa.set(claveObj, "valor asociado con claveObj");
+miMapa.set(claveFunc, "valor asociado with claveFunc");
+
+miMapa.size; // 3
+
+// obteniendo los valores
+miMapa.get(claveCadena);    // "valor asociado con 'una cadena'"
+miMapa.get(claveObj);       // "valor asociado con claveObj"
+miMapa.get(claveFunc);      // "valor asociado con claveFunc"
+
+miMapa.get("una cadena");   // ""valor asociado con 'una cadena'"
+                         // porque claveCadena === 'una cadena'
+miMapa.get({});           // undefined, porque claveObj !== {}
+miMapa.get(function() {}) // undefined, porque claveFunc !== function () {}
+
+ +

Ejemplo: Usando NaN como claves de Map

+ +

NaN también puede ser usado como una clave. Aún cuando cada clave NaN no es igual a sí misma (NaN !== NaN es verdadera), el siguiente ejemplo funciona, porque las claves NaNs NaNs no son distinguibles unas de otras:

+ +
var miMapa = new Map();
+miMapa.set(NaN, "no es un número");
+
+miMapa.get(NaN); // "no es un número"
+
+var otroNaN = Number("foo");
+miMapa.get(otroNaN); // "no es un número"
+
+ +

Ejemplo: Iterando Map con for..of

+ +

Los Map pueden ser iterados usando un bucle for..of:

+ +
var miMapa = new Map();
+miMapa.set(0, "cero");
+miMapa.set(1, "uno");
+for (var [clave, valor] of miMapa) {
+  alert(clave + " = " + valor);
+}
+// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
+
+for (var clave of miMapa.keys()) {
+  alert(clave);
+}
+// Mostrará 2 alertas; primero con "0" y segundo con "1"
+
+for (var valor of miMapa.values()) {
+  alert(valor);
+}
+// Mostrará 2 alertas; primero con "cero" y segundo con "uno"
+
+for (var [clave, valor] of miMapa.entries()) {
+  alert(clave + " = " + valor);
+}
+// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
+
+miMapa.forEach(function(valor, clave, miMapa) {
+  alert(clave + " = " + valor);
+})
+// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
+
+ +

Iterando Maps usando forEach()

+ +

Los Map pueden ser iterados usando el método forEach():

+ +
miMapa.forEach(function(valor, clave) {
+  console.log(clave + ' = ' + valor);
+});
+// Mostrará 2 logs; el primero con "0 = cero" y el segundo con "1 = uno"
+ +

Ejemplo: Relación con los objetos Array

+ +
var kvArray = [["clave1", "valor1"], ["clave2", "valor2"]];
+
+// El constructor por defecto de Map para transforar un Array 2D (clave-valor) en un mapa
+var miMapa = new Map(kvArray);
+
+miMapa.get("clave1"); // devuelve "valor1"
+
+// Usando la función Array.from para transformar el mapa a un Array 2D clave-valor.
+console.log(Array.from(miMapa)); // Muestra exactamente el mismo Array que kvArray
+
+// O usando los iteradores de claves o valores y convirtiendo a array.
+console.log(Array.from(miMapa.keys())); // Muestra ["clave1", "clave2"]
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName('ES6', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidad con Navegadores

+ +

 

+ + + +

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

+ +

 

+ +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..8301bf7867 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,110 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

El metodo keys() returna un nuevo objeto Iterator que contiene las llaves/keys por cada elemento en el objeto en orden de insercion.

+ +

Syntax

+ +
myMap.keys()
+ +

Ejemplos

+ +

Usando keys()

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
+
+ +

See also

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..cd552b8f37 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,134 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript6 + - JavaScript + - Mapa + - Prototype + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

El método set() agrega un nuevo elemento al objeto Map con la llave y el valor especificado.

+ +

Syntax

+ +
myMap.set(llave, valor);
+ +

Parámetros

+ +
+
llave
+
Requerido. La llave del elemento a agregar al objeto Map.
+
valor
+
Requerido. El valor del elemento a agregar al objeto Map.
+
+ +

Valor de retorno

+ +

El objeto Map.

+ +

Ejemplos

+ +

Usando el método set

+ +
var miMapa = new Map();
+
+// Agregar nuevos elementos al mapa
+miMapa.set("bar", "foo");
+miMapa.set(1, "foobar");
+
+// Actualizar un elemento en el mapa
+miMapa.set("bar", "baz");
+
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidad con Navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
CaracteríticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte Básico38{{CompatGeckoDesktop("13.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
CaracteríticaAndroidChrome para AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte Básico{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Notas de compatibilidad

+ + + +

Véase también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..4f3a1fa90d --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,111 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

La propiedad evaluada size retorna el número de elementos en un objeto  {{jsxref("Map")}}.

+ +

Descripción

+ +

El valor de size es un entero representando cuántas entradas tiene el objeto Map. No hay definida una función de evalador set  para size; uted no puede cambiar esta propiedad.

+ +

Ejemplos

+ +

Usando size

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

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Definición inicial.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+ +

Compatibildad entre navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico38{{ CompatGeckoDesktop("19") }}{{ CompatIE("11") }}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatNo}}38{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Notas específicas para Gecko

+ + + +

Ver también

+ + diff --git a/files/es/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/es/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..815a6e75f8 --- /dev/null +++ b/files/es/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - ECMAScript 2015 + - Iterador + - JavaScript + - Map + - Prototipo + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

El método values() devuelve un nuevo objeto Iterador que contiene los valores para cada elemento en el objeto Map en el mismo orden de inserción.

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

Sintaxis

+ +
myMap.values()
+ +

Valor devuelto

+ +

Un nuevo objeto iterador {{jsxref("Map")}}.

+ +

Ejemplos

+ +

Utilizando values()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

Especificaciones

+ + + + + + + + + + + + + + + + + + + +
EspecificaciónEstadoComentario
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidad en navegadores

+ + + +

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

+ +

Ver también

+ + diff --git a/files/es/web/javascript/reference/global_objects/map/clear/index.html b/files/es/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 4bcd625029..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/clear ---- -
{{JSRef}}
- -

El método clear() elimina todos los elementos de un objeto Map.

- -

Sintaxis

- -
myMap.clear();
- -

Ejemplos

- -

Usando el método clear

- -
var myMap = new Map();
-myMap.set("bar", "baz");
-myMap.set(1, "foo");
-
-myMap.size;       // 2
-myMap.has("bar"); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has("bar")  // false
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES6')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad con navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico.38{{CompatGeckoDesktop("19.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico.{{CompatNo}}38{{CompatGeckoMobile("19.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/delete/index.html b/files/es/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index c41a7c38a4..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/delete ---- -
{{JSRef}}
- -

El método delete() elimina el elemento especificado de un objeto Map.

- -

Sintaxis

- -
myMap.delete(clave);
- -

Parámetros

- -
-
clave
-
Requerido. La clave del elemento a eliminar del objeto Map.
-
- -

Valor de retorno

- -

Retorna true si el elemento existe en el objeto Map objecty fue eliminado, o false si el elemento no existe.

- -

Ejemplo

- -

Usando el método delete

- -
var myMap = new Map();
-myMap.set("bar", "foo");
-
-myMap.delete("bar"); // Retorna true. Eliminado con éxito.
-myMap.has("bar");    // Retorna false. El elemento "bar" ya no está presente.
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES6')}}Definición inicial
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}}
- -

Compatibilidad con navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
PrestaciónChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico38{{CompatGeckoDesktop("13.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
PrestaciónAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/entries/index.html b/files/es/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index 2653ccf6e7..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/entries ---- -
{{JSRef}}
- -

El método entries() retorna un nuevo objeto Iterator que contiene los pares [clave, valor] para cada elemento en el objeto Map en orden de inserción.

- -

Sintaxis

- -
myMap.entries()
- -

Ejemplos

- -

Usando entries()

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES6')}}Definición
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad con navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
PrestaciónChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
PrestaciónAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico.{{CompatNo}}38{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
-
- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/foreach/index.html b/files/es/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index fd2750786b..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/forEach ---- -
{{JSRef}}
- -

El método forEach() ejecuta una función por cada par clave / valor en el objeto Map, en orden de inserción.

- -

Sintaxis

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

Parámetros

- -
-
callback
-
Función ejecutada en cada elemento.
-
thisArg
-
Valor a usar por la funcion callback.
-
- -

Valor de Retorno

- -

{{jsxref("undefined")}}.

- -

Descripción

- -

El método forEach ejecuta la devolución de llamada (callback) proporcionada una vez para cada clave del mapa que realmente exista. No se invoca para las claves que se han eliminado. Sin embargo, se ejecuta para los valores que están presentes pero tienen el valor indefinido (undefined).

- -

La función (callback) es invocada con 3 argumentos:

- - - -

Si se provee un parámetro thisArg al método forEach, pasará al callback cuando sea invocado, para ser utilizado como su valor this. De otra manera, el valor undefined pasará para ser usado como su valor this. El valor this finalmente observable por el callback se determina de acuerdo a las reglas usuales para determinar la visibilidad de this por una función.

- -

Cada valor es usado una vez, excepto en este caso cuando es eliminado y agregado de nuevo antes de que el forEach haya terminado. callback no es invocado para valores eliminados antes de que sean usados. 

- -

El método forEach ejecuta la función callback una vez para cada elemento en el objeto Map; No se retornan valores.

- -

Ejemplos

- -

Imprimiendo el contenido de un objeto Map

- -

El siguiente código imprime una línea por cada elemento en el objeto Map:

- -
function logMapElements(value, key, map) {
-    console.log(`m[${key}] = ${value}`);
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
-// logs:
-// "m[foo] = 3"
-// "m[bar] = [object Object]"
-// "m[baz] = undefined"
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definición Inicial.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
- -

Compatibilidad con navegadores

- - - -

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

- -

Véase también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/get/index.html b/files/es/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index fefccec3b4..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/get ---- -
{{JSRef}}
- -

El método get() devuelve un elemento específico de un objeto Map.

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

Sintaxis

- -
miMapa.get(clave);
- -

Parametros

- -
-
clave
-
Requerido. La clave del elemento del objeto Map que queremos obtener.
-
- -

Valor devuelto

- -

Devuelve el elemento asociado a la clave indicada o undefined si la clave no ha sido encontrada en el objeto Map.

- -

Ejemplos

- -

Usando el método get

- -
var miMapa = new Map();
-miMapa.set('bar', 'foo');
-
-miMapa.get('bar');  // Devuelve "foo".
-miMapa.get('baz');  // Devuelve undefined.
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstatusComentario
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

Compatiblidad con navegadores

- - - -

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

- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/has/index.html b/files/es/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index b9bf84412e..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/has ---- -
{{JSRef}}
- -

El método has() devuelve un booleano indicando si el elemento con la llave especificada existe o no.

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

Sintaxis

- -
myMap.has(key)
- -

Parameteros

- -
-
key
-
La llave del elemento a probar si esta presente en el objeto Map.
-
- -

Valor devuelto

- -

true si el elemento con la llave especificada existe en el objeto Map; de lo contrario false.

- -

Ejemplos

- -

Usando has()

- -
let myMap = new Map()
-myMap.set('bar', "foo")
-
-myMap.has('bar')   // returns true
-myMap.has('baz')   // returns false
-
- -

Especificaciones

- - - - - - - - - - -
Especificación
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}
- -

Browser compatibility

- - - -

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

- -

See also

- - diff --git a/files/es/web/javascript/reference/global_objects/map/index.html b/files/es/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 84a3bcbf17..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map ---- -
{{JSRef("Global_Objects", "Map")}}
- -

Resumen

- -

El objeto Map almacena pares clave/valor. Cualquier valor (tanto objetos como {{Glossary("Primitive", "valores primitivos")}}) pueden ser usados como clave o valor.

- -

Sintaxis

- -
new Map([iterable])
-
- -

Parámetros

- -
-
iterable
-
Iterable es un array o cualquier otro objeto iterable cuyos elementos son pares clave-valor (arrays de 2 elementos). Cada par clave-valor será agregado al nuevo Map.
-
- -

Descripción

- -

Un objeto Map puede iterar sobre sus elementos en orden de inserción. Un bucle for..of devolverá un array de [clave, valor] en cada iteración.

- -

Cabe destacar que un Map el cual es un mapa de un objeto, especialmente un diccionario de diccionarios, solo se va a mapear en el orden de inserción del objeto — el cual es aleatorio y no ordenado.

- -

Igualdad de claves

- -

La igualdad de claves esta basada en el algoritmo "SameValueZero": NaN es considerado lo mismo que NaN (sin importar que NaN !== NaN) y todos los otros operadores son considerados iguales de acuerdo a la semantica del operador ===. En las primeras versiones de ECMAScript 6 -0 y +0 eran considarados distintos (even though -0 === +0), esto fue cambiado en posteriores versiones y ha sido implementado en Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) and a recent nightly Chrome.

- -

Objetos y mapas comparados

- -

Los {{jsxref("Object", "Objetos")}} son similares a los Maps en cuanto a que ambos permiten establecer claves a valores, recuperar dichos valores, eliminar claves, y detectar si existe algo almacenado en una clave determinada. Por esto, los Objects han sido usados históricamente como Maps; no obstante, hay diferencias importantes entre  Objects y Maps que hacen mejor usar un  Map  en la mayoría de casos.

- - - -

Propiedades

- -
-
Map.length
-
El valor de la propiedad de longitud es 0
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
La función constructor que se usa para crear objetos derivados.
-
{{jsxref("Map.prototype")}}
-
Representa el prototipo para el constructor de Map. Permite añadir propiedades a todos los objetos Map.
-
- -

Instancias de Map

- -

Todas las instancias de Map heredan de {{jsxref("Map.prototype")}}.

- -

Propiedades

- -

{{page('es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/prototype','Propiedades')}}

- -

Métodos

- -

{{page('es/docs/Web/JavaScript/Referencia/Objetos_globales/Map/prototype','Métodos')}}

- -

Ejemplos

- -

Ejemplo: Usando el objeto Map

- -
var miMapa = new Map();
-
-var claveObj = {},
-    claveFunc = function () {},
-    claveCadena = "una cadena";
-
-// asignando valores
-miMapa.set(claveCadena, "valor asociado con 'una cadena'");
-miMapa.set(claveObj, "valor asociado con claveObj");
-miMapa.set(claveFunc, "valor asociado with claveFunc");
-
-miMapa.size; // 3
-
-// obteniendo los valores
-miMapa.get(claveCadena);    // "valor asociado con 'una cadena'"
-miMapa.get(claveObj);       // "valor asociado con claveObj"
-miMapa.get(claveFunc);      // "valor asociado con claveFunc"
-
-miMapa.get("una cadena");   // ""valor asociado con 'una cadena'"
-                         // porque claveCadena === 'una cadena'
-miMapa.get({});           // undefined, porque claveObj !== {}
-miMapa.get(function() {}) // undefined, porque claveFunc !== function () {}
-
- -

Ejemplo: Usando NaN como claves de Map

- -

NaN también puede ser usado como una clave. Aún cuando cada clave NaN no es igual a sí misma (NaN !== NaN es verdadera), el siguiente ejemplo funciona, porque las claves NaNs NaNs no son distinguibles unas de otras:

- -
var miMapa = new Map();
-miMapa.set(NaN, "no es un número");
-
-miMapa.get(NaN); // "no es un número"
-
-var otroNaN = Number("foo");
-miMapa.get(otroNaN); // "no es un número"
-
- -

Ejemplo: Iterando Map con for..of

- -

Los Map pueden ser iterados usando un bucle for..of:

- -
var miMapa = new Map();
-miMapa.set(0, "cero");
-miMapa.set(1, "uno");
-for (var [clave, valor] of miMapa) {
-  alert(clave + " = " + valor);
-}
-// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
-
-for (var clave of miMapa.keys()) {
-  alert(clave);
-}
-// Mostrará 2 alertas; primero con "0" y segundo con "1"
-
-for (var valor of miMapa.values()) {
-  alert(valor);
-}
-// Mostrará 2 alertas; primero con "cero" y segundo con "uno"
-
-for (var [clave, valor] of miMapa.entries()) {
-  alert(clave + " = " + valor);
-}
-// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
-
-miMapa.forEach(function(valor, clave, miMapa) {
-  alert(clave + " = " + valor);
-})
-// Mostrará 2 alertas; primero con "0 = cero" y segundo con "1 = uno"
-
- -

Iterando Maps usando forEach()

- -

Los Map pueden ser iterados usando el método forEach():

- -
miMapa.forEach(function(valor, clave) {
-  console.log(clave + ' = ' + valor);
-});
-// Mostrará 2 logs; el primero con "0 = cero" y el segundo con "1 = uno"
- -

Ejemplo: Relación con los objetos Array

- -
var kvArray = [["clave1", "valor1"], ["clave2", "valor2"]];
-
-// El constructor por defecto de Map para transforar un Array 2D (clave-valor) en un mapa
-var miMapa = new Map(kvArray);
-
-miMapa.get("clave1"); // devuelve "valor1"
-
-// Usando la función Array.from para transformar el mapa a un Array 2D clave-valor.
-console.log(Array.from(miMapa)); // Muestra exactamente el mismo Array que kvArray
-
-// O usando los iteradores de claves o valores y convirtiendo a array.
-console.log(Array.from(miMapa.keys())); // Muestra ["clave1", "clave2"]
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('ES6', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad con Navegadores

- -

 

- - - -

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

- -

 

- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/keys/index.html b/files/es/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index c3c643180b..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/keys ---- -
{{JSRef}}
- -

El metodo keys() returna un nuevo objeto Iterator que contiene las llaves/keys por cada elemento en el objeto en orden de insercion.

- -

Syntax

- -
myMap.keys()
- -

Ejemplos

- -

Usando keys()

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
- -

Browser compatibility

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
-
- -

See also

- - diff --git a/files/es/web/javascript/reference/global_objects/map/set/index.html b/files/es/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index dd0b48d156..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript6 - - JavaScript - - Mapa - - Prototype - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/set ---- -
{{JSRef}}
- -

El método set() agrega un nuevo elemento al objeto Map con la llave y el valor especificado.

- -

Syntax

- -
myMap.set(llave, valor);
- -

Parámetros

- -
-
llave
-
Requerido. La llave del elemento a agregar al objeto Map.
-
valor
-
Requerido. El valor del elemento a agregar al objeto Map.
-
- -

Valor de retorno

- -

El objeto Map.

- -

Ejemplos

- -

Usando el método set

- -
var miMapa = new Map();
-
-// Agregar nuevos elementos al mapa
-miMapa.set("bar", "foo");
-miMapa.set(1, "foobar");
-
-// Actualizar un elemento en el mapa
-miMapa.set("bar", "baz");
-
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad con Navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
CaracteríticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte Básico38{{CompatGeckoDesktop("13.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
CaracteríticaAndroidChrome para AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte Básico{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Notas de compatibilidad

- - - -

Véase también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/size/index.html b/files/es/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 0671acf15e..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/size ---- -
{{JSRef}}
- -

La propiedad evaluada size retorna el número de elementos en un objeto  {{jsxref("Map")}}.

- -

Descripción

- -

El valor de size es un entero representando cuántas entradas tiene el objeto Map. No hay definida una función de evalador set  para size; uted no puede cambiar esta propiedad.

- -

Ejemplos

- -

Usando size

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

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoObservaciones
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Definición inicial.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
- -

Compatibildad entre navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico38{{ CompatGeckoDesktop("19") }}{{ CompatIE("11") }}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico{{CompatNo}}38{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
-
- -

Notas específicas para Gecko

- - - -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/map/values/index.html b/files/es/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 385a14e3ac..0000000000 --- a/files/es/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - ECMAScript 2015 - - Iterador - - JavaScript - - Map - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values -original_slug: Web/JavaScript/Referencia/Objetos_globales/Map/values ---- -
{{JSRef}}
- -

El método values() devuelve un nuevo objeto Iterador que contiene los valores para cada elemento en el objeto Map en el mismo orden de inserción.

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

Sintaxis

- -
myMap.values()
- -

Valor devuelto

- -

Un nuevo objeto iterador {{jsxref("Map")}}.

- -

Ejemplos

- -

Utilizando values()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

Especificaciones

- - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Definición inicial.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad en navegadores

- - - -

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

- -

Ver también

- - diff --git a/files/fr/_redirects.txt b/files/fr/_redirects.txt index b8ed6aae3c..80f67bafa3 100644 --- a/files/fr/_redirects.txt +++ b/files/fr/_redirects.txt @@ -2421,18 +2421,18 @@ /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/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/JavaScript/Reference/Objets_globaux/Map/clear /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/clear -/fr/docs/JavaScript/Reference/Objets_globaux/Map/delete /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/delete -/fr/docs/JavaScript/Reference/Objets_globaux/Map/entries /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/entries -/fr/docs/JavaScript/Reference/Objets_globaux/Map/forEach /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach -/fr/docs/JavaScript/Reference/Objets_globaux/Map/get /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/get -/fr/docs/JavaScript/Reference/Objets_globaux/Map/has /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/has -/fr/docs/JavaScript/Reference/Objets_globaux/Map/keys /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/keys +/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/Web/JavaScript/Reference/Global_Objects/Map/set -/fr/docs/JavaScript/Reference/Objets_globaux/Map/size /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/size -/fr/docs/JavaScript/Reference/Objets_globaux/Map/values /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/values +/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 @@ -3624,6 +3624,7 @@ /fr/docs/Web/API/Console/erreur /fr/docs/Web/API/Console/error /fr/docs/Web/API/Coordinates /fr/docs/Web/API/GeolocationCoordinates /fr/docs/Web/API/DOMTokenList/DOMTokenList.add() /fr/docs/Web/API/DOMTokenList/add +/fr/docs/Web/API/DOMUserData /fr/docs/orphaned/Web/API/DOMUserData /fr/docs/Web/API/Detecting_device_orientation /fr/docs/orphaned/Web/API/Detecting_device_orientation /fr/docs/Web/API/DeviceOrientationEvent.absolute /fr/docs/Web/API/DeviceOrientationEvent/absolute /fr/docs/Web/API/DeviceRotationRate /fr/docs/Web/API/DeviceMotionEventRotationRate @@ -3799,12 +3800,14 @@ /fr/docs/Web/API/NavigatorOnLine/Évènements_online_et_offline /fr/docs/Web/API/NavigatorOnLine/Online_and_offline_events /fr/docs/Web/API/Node.contains /fr/docs/Web/API/Node/contains /fr/docs/Web/API/Node/baseURIObject /fr/docs/conflicting/Web/API/Node +/fr/docs/Web/API/Node/getUserData /fr/docs/orphaned/Web/API/Node/getUserData /fr/docs/Web/API/Node/innerText /fr/docs/Web/API/HTMLElement/innerText /fr/docs/Web/API/Node/localName /fr/docs/conflicting/Web/API/Element/localName /fr/docs/Web/API/Node/namespaceURI /fr/docs/conflicting/Web/API/Element/namespaceURI /fr/docs/Web/API/Node/nodePrincipal /fr/docs/conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 /fr/docs/Web/API/Node/prefix /fr/docs/conflicting/Web/API/Element/prefix /fr/docs/Web/API/Node/rootNode /fr/docs/conflicting/Web/API/Node/getRootNode +/fr/docs/Web/API/Node/setUserData /fr/docs/orphaned/Web/API/Node/setUserData /fr/docs/Web/API/Notation /fr/docs/orphaned/Web/API/Notation /fr/docs/Web/API/ParentNode /fr/docs/orphaned/Web/API/ParentNode /fr/docs/Web/API/ParentNode/append /fr/docs/orphaned/Web/API/ParentNode/append @@ -4787,6 +4790,20 @@ /fr/docs/Web/JavaScript/Reference/Fonctions_et_portee_des_fonctions/arguments/length /fr/docs/Web/JavaScript/Reference/Functions/arguments/length /fr/docs/Web/JavaScript/Reference/Fonctions_et_portee_des_fonctions/paramètres_du_reste /fr/docs/Web/JavaScript/Reference/Functions/rest_parameters /fr/docs/Web/JavaScript/Reference/Gabarit_chaînes_caractères /fr/docs/Web/JavaScript/Reference/Template_literals +/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/WeakSet/clear /fr/docs/orphaned/Web/JavaScript/Reference/Global_Objects/WeakSet/clear /fr/docs/Web/JavaScript/Reference/Global_Objects/WebAssembly/Global/prototype /fr/docs/conflicting/Web/JavaScript/Reference/Global_Objects/WebAssembly/Global /fr/docs/Web/JavaScript/Reference/Grammaire_lexicale /fr/docs/Web/JavaScript/Reference/Lexical_grammar @@ -5126,21 +5143,21 @@ /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/Web/JavaScript/Reference/Global_Objects/Map -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@iterator /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@species /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/@@toStringTag /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/clear /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/clear -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/delete /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/delete -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/entries /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/entries -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/forEach /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/get /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/get -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/has /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/has -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/keys /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/keys +/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/Web/JavaScript/Reference/Global_Objects/Map/set -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/size /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/size -/fr/docs/Web/JavaScript/Reference/Objets_globaux/Map/values /fr/docs/Web/JavaScript/Reference/Global_Objects/Map/values +/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/_wikihistory.json b/files/fr/_wikihistory.json index ec50449dd3..7a7d37641d 100644 --- a/files/fr/_wikihistory.json +++ b/files/fr/_wikihistory.json @@ -13778,12 +13778,6 @@ "loella16" ] }, - "Web/API/DOMUserData": { - "modified": "2019-03-18T21:41:11.030Z", - "contributors": [ - "loella16" - ] - }, "Web/API/DataTransfer": { "modified": "2019-04-20T00:20:42.022Z", "contributors": [ @@ -18821,12 +18815,6 @@ "loella16" ] }, - "Web/API/Node/getUserData": { - "modified": "2019-03-18T21:40:10.400Z", - "contributors": [ - "loella16" - ] - }, "Web/API/Node/hasChildNodes": { "modified": "2019-03-23T23:54:17.372Z", "contributors": [ @@ -19053,12 +19041,6 @@ "Celelibi" ] }, - "Web/API/Node/setUserData": { - "modified": "2019-03-18T21:39:40.470Z", - "contributors": [ - "loella16" - ] - }, "Web/API/Node/textContent": { "modified": "2020-10-15T21:17:31.045Z", "contributors": [ @@ -37323,112 +37305,6 @@ "teoli" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:27:51.341Z", - "contributors": [ - "innocenzi", - "SphinxKnight", - "ariasuni", - "HelloEdit", - "GodefroyClair", - "kdex", - "Pragmateek", - "lionel", - "Goofy", - "Ltrlg", - "Youle", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { - "modified": "2020-10-15T21:32:15.453Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@species": { - "modified": "2020-10-15T21:36:32.002Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { - "modified": "2020-10-15T21:37:58.832Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-10-15T21:27:50.323Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T21:27:49.784Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2020-10-15T21:27:49.172Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T21:27:50.745Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T21:27:49.108Z", - "contributors": [ - "tomderudder", - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T21:27:49.912Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2020-10-15T21:27:50.316Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-15T21:27:50.400Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-10-15T21:27:52.803Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-10-15T21:27:55.939Z", - "contributors": [ - "SphinxKnight", - "teoli" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:20:01.725Z", "contributors": [ @@ -44829,6 +44705,12 @@ "v-Stein" ] }, + "orphaned/Web/API/DOMUserData": { + "modified": "2019-03-18T21:41:11.030Z", + "contributors": [ + "loella16" + ] + }, "orphaned/Web/API/Detecting_device_orientation": { "modified": "2019-03-23T23:28:22.437Z", "contributors": [ @@ -44892,6 +44774,18 @@ "julienw" ] }, + "orphaned/Web/API/Node/getUserData": { + "modified": "2019-03-18T21:40:10.400Z", + "contributors": [ + "loella16" + ] + }, + "orphaned/Web/API/Node/setUserData": { + "modified": "2019-03-18T21:39:40.470Z", + "contributors": [ + "loella16" + ] + }, "orphaned/Web/API/Notation": { "modified": "2019-03-18T21:40:13.820Z", "contributors": [ @@ -45227,6 +45121,112 @@ "SphinxKnight" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:27:51.341Z", + "contributors": [ + "innocenzi", + "SphinxKnight", + "ariasuni", + "HelloEdit", + "GodefroyClair", + "kdex", + "Pragmateek", + "lionel", + "Goofy", + "Ltrlg", + "Youle", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { + "modified": "2020-10-15T21:32:15.453Z", + "contributors": [ + "SphinxKnight" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species": { + "modified": "2020-10-15T21:36:32.002Z", + "contributors": [ + "SphinxKnight" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { + "modified": "2020-10-15T21:37:58.832Z", + "contributors": [ + "SphinxKnight" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-10-15T21:27:50.323Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T21:27:49.784Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2020-10-15T21:27:49.172Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T21:27:50.745Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T21:27:49.108Z", + "contributors": [ + "tomderudder", + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T21:27:49.912Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2020-10-15T21:27:50.316Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-15T21:27:50.400Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-10-15T21:27:52.803Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-10-15T21:27:55.939Z", + "contributors": [ + "SphinxKnight", + "teoli" + ] + }, "orphaned/Web/JavaScript/Reference/Global_Objects/WeakSet/clear": { "modified": "2020-10-15T21:30:59.712Z", "contributors": [ diff --git a/files/fr/orphaned/web/api/domuserdata/index.html b/files/fr/orphaned/web/api/domuserdata/index.html new file mode 100644 index 0000000000..e762af7e5d --- /dev/null +++ b/files/fr/orphaned/web/api/domuserdata/index.html @@ -0,0 +1,45 @@ +--- +title: DOMUserData +slug: orphaned/Web/API/DOMUserData +tags: + - API + - DOM + - Données utilisateur + - Interface +translation_of: Web/API/DOMUserData +original_slug: Web/API/DOMUserData +--- +

{{ ApiRef("DOM") }}{{Obsolete_header}}

+ +

DOMUserData (données utilisateur) fait référence à une donnée d'application. En JavaScript, elle correspond directement à l'Object. Elle est renvoyée ou utilisée comme argument par Node.setUserData(), Node.getUserData(), comme troisième argument de handle() pour UserDataHandler et par diverses méthodes de DOMConfiguration.

+ +

Notez que bien qu'il puisse s'agir d'un objet, dans Mozilla, elle peut être renvoyée comme chaîne de caractères ou un autre type, si elle a été définie ainsi (par exemple, Node.setUserData() et Node.getUserData()).

+ +

DOMUserData n'est pas persistante ni sérialisée et ne peut être présente après un redémarrage de l'application ou un plantage. Si vous êtes intéressé par la persistance des données, vous devriez plutôt utiliser {{interface("nsISessionStore")}}.

+ +

Spécifications

+ + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName("DOM3 Core", "core.html#DOMUserData", "DOMUserData")}}{{Spec2("DOM3 Core")}}Définition initiale
+ +

Voir aussi

+ + diff --git a/files/fr/orphaned/web/api/node/getuserdata/index.html b/files/fr/orphaned/web/api/node/getuserdata/index.html new file mode 100644 index 0000000000..38a153049f --- /dev/null +++ b/files/fr/orphaned/web/api/node/getuserdata/index.html @@ -0,0 +1,69 @@ +--- +title: Node.getUserData() +slug: orphaned/Web/API/Node/getUserData +tags: + - API + - DOM + - Méthodes + - Noeuds +translation_of: Web/API/Node/getUserData +original_slug: Web/API/Node/getUserData +--- +
{{APIRef("DOM")}}{{obsolete_header}}
+ +

La méthode Node.getUserData()renvoie tout {{domxref("DOMUserData")}} d'utilisateur défini précédemment sur le noeud donné par {{domxref("Node.setUserData()")}}.

+ +
+

Les méthodes Node.setUserData et {{domxref("Node.getUserData")}} ne sont plus disponibles pour le contenu à partir du web. {{domxref("Element.dataset")}} ou WeakMap peuvent être utilisés à la place.

+
+ +

Syntaxe

+ +
userData = someNode.getUserData(userKey);
+ +

Paramètres

+ + + +

Exemple

+ +
var d = document.setUserData('key', 15, null);
+console.log(document.getUserData('key')); // 15
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Supprimée de la spécification.
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Node.getUserData")}}

+ +

Voir aussi

+ + diff --git a/files/fr/orphaned/web/api/node/setuserdata/index.html b/files/fr/orphaned/web/api/node/setuserdata/index.html new file mode 100644 index 0000000000..880bc56265 --- /dev/null +++ b/files/fr/orphaned/web/api/node/setuserdata/index.html @@ -0,0 +1,78 @@ +--- +title: Node.setUserData() +slug: orphaned/Web/API/Node/setUserData +tags: + - API + - DOM + - Données utilisateur + - Méthodes + - Noeuds +translation_of: Web/API/Node/setUserData +original_slug: Web/API/Node/setUserData +--- +
{{APIRef("DOM")}}{{obsolete_header}}
+ +

La méthode Node.setUserData() permet à un utilisateur de joindre (ou supprimer) des données à un élément, sans avoir besoin de modifier le DOM. Notez que ces données ne seront pas conservées lors de l'importation via {{domxref("Node.importNode")}}, comme avec les opérations {{domxref("Node.cloneNode()")}} et {{domxref("Node.renameNode()")}} (bien que {{domxref("Node.adoptNode")}} conserve l'information), et les tests d'égalité dans {{domxref("Node.isEqualNode()")}} ne prennent pas en compte les données de l'utilisateur lors de l'évaluation.

+ +

Cette méthode offre l'avantage d'associer des données à des noeuds spécifiques sans nécessiter de modification de la structure du document et de façon standard, mais cela signifie aussi que des étapes supplémentaires peuvent être nécessaires si l'on souhaite sérialiser l'information ou l'inclure sur un clone, importer ou renommer des opérations.

+ +
+

Les méthodes Node.getUserData et {{domxref("Node.setUserData")}} ne sont plus disponibles depuis le contenu Web. {{domxref("HTMLElement.dataset")}} ou WeakMap peuvent être utilisées à la place.

+
+ +

Syntaxe

+ +
var prevUserData = someNode.setUserData(userKey, userData, handler);
+ +

Paramètres

+ + + +

Exemple

+ +
var d = document.implementation.createDocument('', 'test', null);
+d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
+console.log(d.documentElement.getUserData('key')); // 15
+var e = document.importNode(d.documentElement, true); // provoque l'appel du gestionnaire
+console.log(e.getUserData('key')); // null puisque les données utilisateur ne sont pas copiées.
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Supprimé de la  spécification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Node.setUserData")}}

+ +

Voir aussi

+ + 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 new file mode 100644 index 0000000000..5eb65fed52 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html @@ -0,0 +1,91 @@ +--- +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 new file mode 100644 index 0000000000..e5311496a4 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@species/index.html @@ -0,0 +1,71 @@ +--- +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 new file mode 100644 index 0000000000..a1487397a3 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,56 @@ +--- +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 new file mode 100644 index 0000000000..af316a5d35 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,77 @@ +--- +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 new file mode 100644 index 0000000000..814e9e22ea --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,76 @@ +--- +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 new file mode 100644 index 0000000000..d464cd80c1 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,80 @@ +--- +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 new file mode 100644 index 0000000000..ecc3e13e12 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,104 @@ +--- +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 new file mode 100644 index 0000000000..3d778e6c82 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,78 @@ +--- +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 new file mode 100644 index 0000000000..052d8fb6d9 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,78 @@ +--- +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 new file mode 100644 index 0000000000..ff9d204289 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,276 @@ +--- +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 new file mode 100644 index 0000000000..c57e06c9b9 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,77 @@ +--- +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 new file mode 100644 index 0000000000..3b6e5f8612 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,95 @@ +--- +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 new file mode 100644 index 0000000000..59f85f7a91 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,67 @@ +--- +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 new file mode 100644 index 0000000000..34c7d20f78 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,77 @@ +--- +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/api/domuserdata/index.html b/files/fr/web/api/domuserdata/index.html deleted file mode 100644 index 6a78b4cd94..0000000000 --- a/files/fr/web/api/domuserdata/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: DOMUserData -slug: Web/API/DOMUserData -tags: - - API - - DOM - - Données utilisateur - - Interface -translation_of: Web/API/DOMUserData ---- -

{{ ApiRef("DOM") }}{{Obsolete_header}}

- -

DOMUserData (données utilisateur) fait référence à une donnée d'application. En JavaScript, elle correspond directement à l'Object. Elle est renvoyée ou utilisée comme argument par Node.setUserData(), Node.getUserData(), comme troisième argument de handle() pour UserDataHandler et par diverses méthodes de DOMConfiguration.

- -

Notez que bien qu'il puisse s'agir d'un objet, dans Mozilla, elle peut être renvoyée comme chaîne de caractères ou un autre type, si elle a été définie ainsi (par exemple, Node.setUserData() et Node.getUserData()).

- -

DOMUserData n'est pas persistante ni sérialisée et ne peut être présente après un redémarrage de l'application ou un plantage. Si vous êtes intéressé par la persistance des données, vous devriez plutôt utiliser {{interface("nsISessionStore")}}.

- -

Spécifications

- - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName("DOM3 Core", "core.html#DOMUserData", "DOMUserData")}}{{Spec2("DOM3 Core")}}Définition initiale
- -

Voir aussi

- - diff --git a/files/fr/web/api/node/getuserdata/index.html b/files/fr/web/api/node/getuserdata/index.html deleted file mode 100644 index 76ffd3ce25..0000000000 --- a/files/fr/web/api/node/getuserdata/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Node.getUserData() -slug: Web/API/Node/getUserData -tags: - - API - - DOM - - Méthodes - - Noeuds -translation_of: Web/API/Node/getUserData ---- -
{{APIRef("DOM")}}{{obsolete_header}}
- -

La méthode Node.getUserData()renvoie tout {{domxref("DOMUserData")}} d'utilisateur défini précédemment sur le noeud donné par {{domxref("Node.setUserData()")}}.

- -
-

Les méthodes Node.setUserData et {{domxref("Node.getUserData")}} ne sont plus disponibles pour le contenu à partir du web. {{domxref("Element.dataset")}} ou WeakMap peuvent être utilisés à la place.

-
- -

Syntaxe

- -
userData = someNode.getUserData(userKey);
- -

Paramètres

- - - -

Exemple

- -
var d = document.setUserData('key', 15, null);
-console.log(document.getUserData('key')); // 15
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Supprimée de la spécification.
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.getUserData")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/node/setuserdata/index.html b/files/fr/web/api/node/setuserdata/index.html deleted file mode 100644 index 05a84f37d4..0000000000 --- a/files/fr/web/api/node/setuserdata/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Node.setUserData() -slug: Web/API/Node/setUserData -tags: - - API - - DOM - - Données utilisateur - - Méthodes - - Noeuds -translation_of: Web/API/Node/setUserData ---- -
{{APIRef("DOM")}}{{obsolete_header}}
- -

La méthode Node.setUserData() permet à un utilisateur de joindre (ou supprimer) des données à un élément, sans avoir besoin de modifier le DOM. Notez que ces données ne seront pas conservées lors de l'importation via {{domxref("Node.importNode")}}, comme avec les opérations {{domxref("Node.cloneNode()")}} et {{domxref("Node.renameNode()")}} (bien que {{domxref("Node.adoptNode")}} conserve l'information), et les tests d'égalité dans {{domxref("Node.isEqualNode()")}} ne prennent pas en compte les données de l'utilisateur lors de l'évaluation.

- -

Cette méthode offre l'avantage d'associer des données à des noeuds spécifiques sans nécessiter de modification de la structure du document et de façon standard, mais cela signifie aussi que des étapes supplémentaires peuvent être nécessaires si l'on souhaite sérialiser l'information ou l'inclure sur un clone, importer ou renommer des opérations.

- -
-

Les méthodes Node.getUserData et {{domxref("Node.setUserData")}} ne sont plus disponibles depuis le contenu Web. {{domxref("HTMLElement.dataset")}} ou WeakMap peuvent être utilisées à la place.

-
- -

Syntaxe

- -
var prevUserData = someNode.setUserData(userKey, userData, handler);
- -

Paramètres

- - - -

Exemple

- -
var d = document.implementation.createDocument('', 'test', null);
-d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {console.log(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
-console.log(d.documentElement.getUserData('key')); // 15
-var e = document.importNode(d.documentElement, true); // provoque l'appel du gestionnaire
-console.log(e.getUserData('key')); // null puisque les données utilisateur ne sont pas copiées.
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Supprimé de la  spécification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

{{Compat("api.Node.setUserData")}}

- -

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 deleted file mode 100644 index 63f7719ab3..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/@@iterator/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index d7380d8e91..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index a3496ce6ea..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 0060c8c82d..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 8b5aa26f68..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 5e379550f8..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index b1af8cf491..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 7c396b3eb7..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index c433e7b276..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 3bb197e93c..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,276 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index bc4bf893e4..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index b414c6cad1..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 50c0118a9d..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -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/Objets_globaux/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 deleted file mode 100644 index 72036951c4..0000000000 --- a/files/fr/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -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/Objets_globaux/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/ja/_redirects.txt b/files/ja/_redirects.txt index a8e0285946..b146be359d 100644 --- a/files/ja/_redirects.txt +++ b/files/ja/_redirects.txt @@ -3916,8 +3916,9 @@ /ja/docs/Web/API/Node.replaceChild /ja/docs/Web/API/Node/replaceChild /ja/docs/Web/API/Node.textContent /ja/docs/Web/API/Node/textContent /ja/docs/Web/API/Node/baseURIObject /ja/docs/conflicting/Web/API/Node -/ja/docs/Web/API/Node/cloneNode-old /ja/docs/Web/API/Node/getUserData +/ja/docs/Web/API/Node/cloneNode-old /ja/docs/orphaned/Web/API/Node/getUserData /ja/docs/Web/API/Node/firstChild-temp /ja/docs/Web/API/Node/firstChild +/ja/docs/Web/API/Node/getUserData /ja/docs/orphaned/Web/API/Node/getUserData /ja/docs/Web/API/Node/innerText /ja/docs/Web/API/HTMLElement/innerText /ja/docs/Web/API/Node/localName /ja/docs/conflicting/Web/API/Element/localName /ja/docs/Web/API/Node/namespaceURI /ja/docs/Web/API/Element/namespaceURI @@ -4933,7 +4934,22 @@ /ja/docs/Web/JavaScript/Reference/Global_Objects/Locale/region /ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/region /ja/docs/Web/JavaScript/Reference/Global_Objects/Locale/script /ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/script /ja/docs/Web/JavaScript/Reference/Global_Objects/Locale/toString /ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/toString -/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /ja/docs/Web/JavaScript/Reference/Global_Objects/Map +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/Map /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/get /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/has /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/set /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/size /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/ja/docs/Web/JavaScript/Reference/Global_Objects/Map/values /ja/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /ja/docs/Web/JavaScript/Reference/Global_Objects/Number/constructor /ja/docs/Web/JavaScript/Reference/Global_Objects/Number /ja/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /ja/docs/Web/JavaScript/Reference/Global_Objects/Number /ja/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat diff --git a/files/ja/_wikihistory.json b/files/ja/_wikihistory.json index 7524a08d19..30eea2fe9b 100644 --- a/files/ja/_wikihistory.json +++ b/files/ja/_wikihistory.json @@ -19454,19 +19454,6 @@ "mfuji09" ] }, - "Web/API/Node/getUserData": { - "modified": "2020-10-15T21:14:35.305Z", - "contributors": [ - "mfuji09", - "AshfaqHossain", - "teoli", - "ethertank", - "dextra", - "Potappo", - "Mgjbot", - "Shoot" - ] - }, "Web/API/Node/hasChildNodes": { "modified": "2019-03-24T00:04:08.018Z", "contributors": [ @@ -41255,148 +41242,6 @@ "teoli" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-11-06T12:58:07.510Z", - "contributors": [ - "mfuji09", - "mpcjazz", - "eltociear", - "kachick", - "dlwe", - "BuminMacintosh", - "woodmix", - "daikiueda", - "YuichiNukiyama", - "PandaNoir", - "lv7777", - "Hixhi", - "ocha" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { - "modified": "2020-11-06T02:35:29.985Z", - "contributors": [ - "mfuji09", - "mpcjazz", - "Kisaragi", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@species": { - "modified": "2020-11-06T05:22:22.573Z", - "contributors": [ - "mfuji09", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { - "modified": "2020-10-15T21:39:55.689Z", - "contributors": [ - "mfuji09", - "Kisaragi", - "YuichiNukiyama" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/Map": { - "modified": "2020-11-06T12:31:37.635Z", - "contributors": [ - "mfuji09" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-11-06T05:11:45.291Z", - "contributors": [ - "mfuji09", - "segayuu", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-11-06T02:41:53.398Z", - "contributors": [ - "mfuji09", - "mpcjazz", - "segayuu", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2020-10-17T09:59:44.238Z", - "contributors": [ - "mfuji09", - "segayuu", - "woodmix", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-17T09:19:37.508Z", - "contributors": [ - "mfuji09", - "u_7cc", - "woodmix", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-16T22:01:27.590Z", - "contributors": [ - "mfuji09", - "yuta0801", - "segayuu", - "SphinxKnight", - "ledsun", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-16T21:43:06.831Z", - "contributors": [ - "mfuji09", - "segayuu", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2020-11-06T04:31:09.409Z", - "contributors": [ - "mfuji09", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-16T21:36:15.305Z", - "contributors": [ - "mfuji09", - "mpcjazz", - "isdh", - "SphinxKnight", - "mayuowww", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-11-06T12:27:52.241Z", - "contributors": [ - "mfuji09", - "SphinxKnight", - "shide55" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-11-06T02:54:38.454Z", - "contributors": [ - "mfuji09", - "woodmix", - "shide55" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:13:37.581Z", "contributors": [ @@ -52188,6 +52033,19 @@ "ethertank" ] }, + "orphaned/Web/API/Node/getUserData": { + "modified": "2020-10-15T21:14:35.305Z", + "contributors": [ + "mfuji09", + "AshfaqHossain", + "teoli", + "ethertank", + "dextra", + "Potappo", + "Mgjbot", + "Shoot" + ] + }, "orphaned/Web/API/ParentNode": { "modified": "2020-11-23T03:46:53.867Z", "contributors": [ @@ -52971,6 +52829,148 @@ "mfuji09" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-11-06T12:58:07.510Z", + "contributors": [ + "mfuji09", + "mpcjazz", + "eltociear", + "kachick", + "dlwe", + "BuminMacintosh", + "woodmix", + "daikiueda", + "YuichiNukiyama", + "PandaNoir", + "lv7777", + "Hixhi", + "ocha" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { + "modified": "2020-11-06T02:35:29.985Z", + "contributors": [ + "mfuji09", + "mpcjazz", + "Kisaragi", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species": { + "modified": "2020-11-06T05:22:22.573Z", + "contributors": [ + "mfuji09", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { + "modified": "2020-10-15T21:39:55.689Z", + "contributors": [ + "mfuji09", + "Kisaragi", + "YuichiNukiyama" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map": { + "modified": "2020-11-06T12:31:37.635Z", + "contributors": [ + "mfuji09" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-11-06T05:11:45.291Z", + "contributors": [ + "mfuji09", + "segayuu", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-11-06T02:41:53.398Z", + "contributors": [ + "mfuji09", + "mpcjazz", + "segayuu", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2020-10-17T09:59:44.238Z", + "contributors": [ + "mfuji09", + "segayuu", + "woodmix", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-17T09:19:37.508Z", + "contributors": [ + "mfuji09", + "u_7cc", + "woodmix", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-16T22:01:27.590Z", + "contributors": [ + "mfuji09", + "yuta0801", + "segayuu", + "SphinxKnight", + "ledsun", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-16T21:43:06.831Z", + "contributors": [ + "mfuji09", + "segayuu", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2020-11-06T04:31:09.409Z", + "contributors": [ + "mfuji09", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-16T21:36:15.305Z", + "contributors": [ + "mfuji09", + "mpcjazz", + "isdh", + "SphinxKnight", + "mayuowww", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-11-06T12:27:52.241Z", + "contributors": [ + "mfuji09", + "SphinxKnight", + "shide55" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-11-06T02:54:38.454Z", + "contributors": [ + "mfuji09", + "woodmix", + "shide55" + ] + }, "orphaned/Web/JavaScript/Reference/Global_Objects/WeakSet/clear": { "modified": "2019-03-23T22:54:31.675Z", "contributors": [ diff --git a/files/ja/orphaned/web/api/node/getuserdata/index.html b/files/ja/orphaned/web/api/node/getuserdata/index.html new file mode 100644 index 0000000000..cbee8185f6 --- /dev/null +++ b/files/ja/orphaned/web/api/node/getuserdata/index.html @@ -0,0 +1,69 @@ +--- +title: Node.getUserData() +slug: orphaned/Web/API/Node/getUserData +tags: + - API + - DOM + - Method + - Node + - Obsolete + - Reference + - メソッド +translation_of: Web/API/Node/getUserData +original_slug: Web/API/Node/getUserData +--- +
{{APIRef("DOM")}}{{obsolete_header}}
+ +

Node.getUserData() メソッドは、以前 {{domxref("Node.setUserData()")}} によってノードに設定されたすべてのユーザーデータを {{domxref("DOMUserData")}} 形式で返します。

+ +
+

Node.setUserData および {{domxref("Node.getUserData")}} メソッドはウェブコンテンツから利用できなくなりました。 {{domxref("Element.dataset")}} または WeakMap を代わりに利用することができます。

+
+ +

構文

+ +
userData = someNode.getUserData(userKey);
+ +

引数

+ + + +

例

+ +
var d = document.setUserData('key', 15, null);
+console.log(document.getUserData('key')); // 15
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Node.getUserData")}}

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html new file mode 100644 index 0000000000..b94b3623f6 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html @@ -0,0 +1,96 @@ +--- +title: Map.prototype[@@iterator]() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +--- +
{{JSRef}}
+ +

@@iterator プロパティの初期値は、 {{jsxref("Map.prototype.entries()", "entries")}} メソッドの初期値と同じ関数オブジェクトです。

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

構文

+ +
myMap[Symbol.iterator]
+ +

返値

+ +

マップの iterator 関数で、既定では {{jsxref("Map.prototype.entries()", "entries()")}} 関数です。

+ +

例

+ +

[@@iterator]() の使用

+ +
const myMap = new Map()
+myMap.set('0', 'foo')
+myMap.set(1, 'bar')
+myMap.set({}, 'baz')
+
+const mapIter = myMap[Symbol.iterator]()
+
+console.log(mapIter.next().value) // ["0", "foo"]
+console.log(mapIter.next().value) // [1, "bar"]
+console.log(mapIter.next().value) // [Object, "baz"]
+
+ +

[@@iterator]() と for..of の併用

+ +
const myMap = new Map()
+myMap.set('0', 'foo')
+myMap.set(1, 'bar')
+myMap.set({}, 'baz')
+
+for (const entry of myMap) {
+  console.log(entry)
+}
+// ["0", "foo"]
+// [1, "bar"]
+// [{}, "baz"]
+
+for (const [key, value] of myMap) {
+  console.log(`${key}: ${value}`)
+}
+// 0: foo
+// 1: bar
+// [Object]: baz
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

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

Map[@@species] アクセサープロパティは、 Map コンストラクターを返します。

+ +

解説

+ +

species アクセサープロパティは Map オブジェクトのデフォルトコンストラクターを返します。サブクラスのコンストラクターは、コンストラクターに代入して変更することによりオーバーライドすることができます。

+ +

例

+ +

通常のオブジェクトの species

+ +

species プロパティはデフォルトコンストラクター関数を返しますので、 Map オブジェクトには Map コンストラクターを返します。

+ +
Map[Symbol.species]; // function Map()
+ +

派生オブジェクトの species

+ +

派生したコレクションオブジェクトの中では (例えばカスタムマップである MyMap)、 MyMap の species は MyMap コンストラクターになっています。しかし、これをオーバーライドして、派生クラスのメソッド内で親の Map オブジェクトを返したい場合があります。

+ +
class MyMap extends Map {
+  // Overwrite MyMap species to the parent Map constructor
+  static get [Symbol.species]() { return Map; }
+}
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}
+ +

ブラウザーの互換性

+ +
+ + +

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

+
+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html new file mode 100644 index 0000000000..71e548d7f2 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,61 @@ +--- +title: Map.prototype[@@toStringTag] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property + - Prototype + - Reference + - プロパティ +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +--- +
{{JSRef}}
+ +

Map[@@toStringTag] プロパティは、 "Map" の初期値を持ちます。

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

構文

+ +
Map[Symbol.toStringTag]
+ +

例

+ +

toStringTag の使用

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

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

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

clear() メソッドは Map オブジェクトからすべての要素を削除します。

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

構文

+ +
myMap.clear();
+
+ +

返値

+ +

{{jsxref("undefined")}}.

+ +

例

+ +

clear() の使用

+ +
var myMap = new Map();
+myMap.set('bar', 'baz');
+myMap.set(1, 'foo');
+
+myMap.size;       // 2
+myMap.has('bar'); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has('bar')  // false
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

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

delete() メソッドは Map オブジェクトから特定の要素を削除します。

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

構文

+ +
myMap.delete(key);
+ +

引数

+ +
+
key
+
Map オブジェクトから削除する要素のキーです。
+
+ +

返値

+ +

Map オブジェクトの要素が削除されたら true を、要素が存在しなければ false を返します。

+ +

例

+ +

delete() メソッドの使用

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.delete('bar'); // 正常に削除出来れば true を返す
+myMap.has('bar');    // 存在しない要素を確認すると false を返す
+
+ +

仕様書

+ + + + + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..6eb6e759f8 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,72 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

entries() メソッドは、挿入順で Map オブジェクトの要素に対する [key, value] ペアを含む新しい Iterator オブジェクトを返します。

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

構文

+ +
myMap.entries()
+ +

返値

+ +

新しい {{jsxref("Map")}} の反復子オブジェクトです。

+ +

例

+ +

entries() の使用

+ +
let myMap = new Map()
+myMap.set('0', 'foo')
+myMap.set(1, 'bar')
+myMap.set({}, 'baz')
+
+let mapIter = myMap.entries()
+
+console.log(mapIter.next().value)  // ["0", "foo"]
+console.log(mapIter.next().value)  // [1, "bar"]
+console.log(mapIter.next().value)  // [Object, "baz"]
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..0e4c97db61 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,108 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

forEach() メソッドは、指定された関数を Map オブジェクト内にあるキーと値のペアそれぞれに対して1回ずつ、挿入順に実行します。

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

構文

+ +
myMap.forEach(callback([value][, key][, map])[, thisArg])
+ +

引数

+ +
+
callback
+
+

myMap のそれぞれの項目に対して実行される関数。以下の引数を取ります。

+ +
+
value {{Optional_Inline}}
+
それぞれの反復処理における値です。
+
key {{Optional_Inline}}
+
それぞれの反復処理におけるキーです。
+
map {{Optional_Inline}}
+
反復処理されるマップです (上記の構文ボックスでは myMap です)。
+
+
+
thisArg {{Optional_Inline}}
+
callback の実行時に this として使用される値です。
+
+ +

返値

+ +

{{jsxref("undefined")}} です。

+ +

解説

+ +

forEach メソッドは、指定された関数 callback を、マップの実在するそれぞれのキーに対して一度ずつ呼び出します。これは削除されたキーに対しては呼び出しません。ただし、存在していて undefined である値に対しては呼び出します。

+ +

callback は次の 3 つの引数で呼び出されます。

+ + + +

thisArg 引数が forEach に指定されると、 callback の呼び出し時にそのオブジェクトが this の値として使用されます。与えられなかった場合は、 undefined が this の値として渡されます。 callback によって究極に管理される this の値は、関数から見える this を特定する一般規則に従います。

+ +

それぞれの値に対して一度ずつ実行されますが、 forEach が終了するまでに削除され再追加された場合は除きます。 callback はその前に削除された値に対しては実行されません。 forEach が終了する前に追加された新しい値に対しては実行されます。

+ +

例

+ +

Map オブジェクトの内容を表示

+ +

以下のコードは Map オブジェクト内の各要素を1行ずつ出力します。

+ +
function logMapElements(value, key, map) {
+    console.log(`map.get('${key}') = ${value}`)
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements)
+// logs:
+// "map.get('foo') = 3"
+// "map.get('bar') = [object Object]"
+// "map.get('baz') = undefined"
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..9bf0cd9795 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,73 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

get() メソッドは、指定された要素を Map オブジェクトから返します。指定されたキーに関連付けられた値がオブジェクトである場合は、そのオブジェクトの参照を受け取ることになり、そのオブジェクトに対して変更を行った場合は、 Map オブジェクトの中にあるものに変更が行われます。

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

構文

+ +
myMap.get(key)
+ +

引数

+ +
+
key
+
Map オブジェクトから返される要素のキーです。
+
+ +

返値

+ +

指定されたキーに関連付けられた要素が返されます。 Map オブジェクト内にキーが見つからない場合は、 undefined を返されます。

+ +

例

+ +

Using get()

+ +
let myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');   // "foo" を返す
+myMap.get('baz');   // undefined を返す
+
+ +

仕様書

+ + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..24cc796b66 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,73 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

has() メソッドは、指定されたキーに対する要素が存在するかどうかを示す論理値を返します。

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

構文

+ +
myMap.has(key)
+ +

引数

+ +
+
key
+
Map オブジェクト内に存在するかテストするための要素のキーです。
+
+ +

返値

+ +

特定のキーに対する要素が Map オブジェクト内に存在していたら、true を返します。さもなければ、false を返します。

+ +

例

+ +

has() の使用

+ +
let myMap = new Map()
+myMap.set('bar', "foo")
+
+myMap.has('bar')   // returns true
+myMap.has('baz')   // returns false
+
+ +

仕様書

+ + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..622df5464a --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,370 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - Class + - ECMAScript 2015 + - JavaScript + - Map + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +

Map オブジェクトはキーと値のペアを保持し、キーが最初に挿入された順序を覚えています。キーや値には任意の値 (オブジェクトと{{glossary("Primitive", "プリミティブ値")}})を使用することができます。

+ +

解説

+ +

Map オブジェクトは、その要素について挿入順で反復処理を行うことができます。 {{jsxref("Statements/for...of", "for...of")}} ループは各反復で [キー, 値] の配列を返します。

+ +

キーの等価性

+ + + +

Object と Map の比較

+ +

{{jsxref("Object")}} と Map は似ています。 — どちらもキーを値に設定したり、それらの値を受け取ったり、キーを削除したり、キーに何かが格納されているかどうかを判定したりすることができます。この意味で (そして他の内蔵オブジェクトがなかったため)、従来 Object は Map として使われてきました。

+ +

しかし、いくつかの場面で Map の方が勝るような重要な違いがあります。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MapObject
思いがけないキーMap は既定では何もキーを持っていません。明示的に設定したものだけを含みます。 +

Object にはプロトタイプがあります。よって既定のキーを含んでいるので、注意しないと自分のキーと衝突する可能性があります。

+ +
+

注: ES5 では、 {{jsxref("Object.create", "Object.create(null)")}} を使用すると回避できますが、これはめったに行われていません。

+
+
キーの型Map のキーはあらゆる値がなることができます (関数、オブジェクト、あらゆるプリミティブなど)。Object のキーは {{jsxref("String")}} または {{jsxref("Symbol")}} でなければなりません。
キーの順序 +

Map のキーは、単純で直感的な方法で順序付けられます。すなわち、反復処理を行うと、 Map オブジェクトは挿入順でキーを返します。

+ 		+

通常の Object のキーは現在では順序付けされていますが、以前はそうではなかったので、順序は複雑です。結果として、プロパティの順序に頼らない方が良いでしょう。

+ +

この順序は ECMAScript 2015 で初めて自身のプロパティに対してのみ定義されましたが、 ECMAScript 2020 では継承されたプロパティに対しても同様に順序が定義されています。 OrdinaryOwnPropertyKeys と EnumerateObjectProperties の抽象指定操作を参照してください。しかし、オブジェクトのプロパティがすべて反復処理される単一の単一のメカニズムはないことに注意してください。 ({{jsxref("Statements/for...in", "for-in")}} は列挙可能な文字列キーのプロパティのみを含む、 {{jsxref("Object.keys")}} は自分自身の列挙可能な文字列キーのプロパティのみを含む、 {{jsxref("Object.getOwnPropertyNames")}} は列挙不可能な場合でも自分自身の文字列キーのプロパティを含む、 {{jsxref("Object.getOwnPropertySymbols")}} は、 Symbol キーを持つプロパティに対しても同じことを行う、など。)

+
+

大きさ

+ 		Map の中の項目数は、 {{jsxref("Map.prototype.size", "size")}} プロパティで簡単に得ることができます。 property.Object の中の項目数は、手動で数える必要があります。
反復処理Map は iterable ですので、直接反復処理を行うことができます。Object では反復処理を行うのに、いくつかの形でキーの一覧を取得して、そのうえで反復処理を行う必要があります。
性能 +

キーと値の組を頻繁に追加したり削除したりすることが求められるシナリオでは、性能がより良くなります。

+ 		+

キーと値の組を頻繁に追加したり削除したりすることに最適化されていません。

+
+ +

オブジェクトプロパティの設定

+ +

Map オブジェクトに対してオブジェクトプロパティを設定すると正しく動作しますが、混乱を催すことが考えられます。

+ +

たとえば、次の例は一応動作するように見えます。

+ +
let wrongMap = new Map()
+wrongMap['bla'] = 'blaa'
+wrongMap['bla2'] = 'blaaa2'
+
+console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
+
+ +

しかし、このようにプロパティを設定すると、 Map データ構造に符合しません。一般的なオブジェクトの機能を使用します。 'bla' の値はクエリを行うための Map に格納されません。データにその他の操作を行うと失敗します。

+ +
wrongMap.has('bla')    // false
+wrongMap.delete('bla') // false
+console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
+ +

Map にデータを格納する正しい方法は、 set(key, value) メソッドを使用する方法です。

+ +
let contacts = new Map()
+contacts.set('Jessie', {phone: "213-555-1234", address: "123 N 1st Ave"})
+contacts.has('Jessie') // true
+contacts.get('Hilary') // undefined
+contacts.set('Hilary', {phone: "617-555-4321", address: "321 S 2nd St"})
+contacts.get('Jessie') // {phone: "213-555-1234", address: "123 N 1st Ave"}
+contacts.delete('Raymond') // false
+contacts.delete('Jessie') // true
+console.log(contacts.size) // 1
+
+
+ +

コンストラクター

+ +
+
{{jsxref("Map/Map", "Map()")}}
+
新しい Map オブジェクトを生成します。
+
+ +

静的プロパティ

+ +
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
派生クラスを生成するためのコンストラクター関数です。
+
+ +

インスタンスプロパティ

+ +
+
{{jsxref("Map.prototype.size")}}
+
Map オブジェクトの中のキーと値の組の数を返します。
+
+ +

インスタンスメソッド

+ +
+
{{jsxref("Map.prototype.clear()")}}
+
Mapオブジェクトからすべてのキーと値の組を削除します。
+
{{jsxref("Map.delete", "Map.prototype.delete(key)")}}
+
Map オブジェクトに要素が存在し、削除された場合は true を返します、要素が存在しなければ false を返します。その後では Map.prototype.has(key) が false を返すようになります。
+
{{jsxref("Map.get", "Map.prototype.get(key)")}}
+
key で指定されたキーに結び付けられた値を返します。存在しない場合は undefined を返します。
+
{{jsxref("Map.has", "Map.prototype.has(key)")}}
+
key で指定されたキーに結び付けられた要素が Map オブジェクト内に存在するかどうかを示す boolean を返します。
+
{{jsxref("Map.set", "Map.prototype.set(key, value)")}}
+
Map オブジェクト内の key で指定されたキーの値を value に設定します。その Map オブジェクトを返します。
+
+ +

反復処理メソッド

+ +
+
{{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}
+
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素の [key, value] の配列が挿入順で含まれます。
+
{{jsxref("Map.prototype.keys()")}}
+
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素のキーが挿入順で含まれます。
+
{{jsxref("Map.prototype.values()")}}
+
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素の値が挿入順で含まれます。
+
{{jsxref("Map.prototype.entries()")}}
+
Mapオブジェクト内の要素に対して挿入順にすべての要素の [key, value] の配列を含む、新しいイテレーターオブジェクトを返します。
+
{{jsxref("Map.forEach", "Map.prototype.forEach(callbackFn[, thisArg])")}}
+
callbackFn を、 Map オブジェクトに存在するそれぞれのキーと値の組に対して1回ずつ、挿入順に呼び出します。 thisArg 引数が forEach に与えられた場合は、それぞれのコールバックでこれを this の値として使用します。
+
+ +

例

+ +

Map オブジェクトの使用

+ +
let myMap = new Map()
+
+let keyString = '文字列'
+let keyObj    = {}
+let keyFunc   = function() {}
+
+// 値を設定する
+myMap.set(keyString, "'文字列' と結び付けられた値")
+myMap.set(keyObj, "keyObj と結び付けられた値")
+myMap.set(keyFunc, "keyFunc と結び付けられた値")
+
+myMap.size              // 3
+
+// 値を取得する
+myMap.get(keyString)    // "'文字列' と結び付けられた値"
+myMap.get(keyObj)       // "keyObj と結び付けられた値"
+myMap.get(keyFunc)      // "keyFunc と結び付けられた値"
+
+myMap.get('文字列')     // "'文字列' と結び付けられた値"
+                        // keyString === '文字列' であるため
+myMap.get({})           // undefined, keyObj !== {} であるため
+myMap.get(function() {}) // undefined, keyFunc !== function () {} であるため
+
+ +

NaN を Map のキーとして使用

+ +

{{jsxref("NaN")}} もまたキーとして使うことができます。すべての NaN は自身と等しくない (NaN !== NaN は真) にもかかわらず、以下の例は動作します。これは NaN が互いに区別できないためです。

+ +
let myMap = new Map()
+myMap.set(NaN, 'not a number')
+
+myMap.get(NaN)
+// "not a number"
+
+let otherNaN = Number('foo')
+myMap.get(otherNaN)
+// "not a number"
+
+ +

for..of を使用した Map の反復処理

+ +

Map は for..of ループを使用して反復処理を行うことができます。

+ +
let myMap = new Map()
+myMap.set(0, 'zero')
+myMap.set(1, 'one')
+
+for (let [key, value] of myMap) {
+  console.log(key + ' = ' + value)
+}
+// 0 = zero
+// 1 = one
+
+for (let key of myMap.keys()) {
+  console.log(key)
+}
+// 0
+// 1
+
+for (let value of myMap.values()) {
+  console.log(value)
+}
+// zero
+// one
+
+for (let [key, value] of myMap.entries()) {
+  console.log(key + ' = ' + value)
+}
+// 0 = zero
+// 1 = one
+
+ +

forEach() で Map を反復処理

+ +

Map は {{jsxref("Map.prototype.forEach", "forEach()")}} メソッドを使用して反復できます。

+ +
myMap.forEach(function(value, key) {
+  console.log(key + ' = ' + value)
+})
+// 0 = zero
+// 1 = one
+
+ +

Array オブジェクトとの関係

+ +
let kvArray = [["キー1", "値1"], ["キー2", "値2"]];
+
+// 通常の Map コンストラクターを使って、キー・値の 2 次元配列をマップに変換する
+let myMap = new Map(kvArray)
+
+myMap.get("キー1") // "値1" を返す
+
+// 展開演算子を使って、マップをキー・値の 2 次元配列に変換する
+console.log(Array.from(myMap)) // kvArray とまったく同じ Array を表示する
+
+// あるいは展開演算子をキーまたは値のイテレーターに使って、キーまたは値のみの配列を得る
+console.log([...myMap])
+
+// または keys() や values() のイテレーターを使用して配列に変換する
+console.log(Array.from(myMap.keys())) // ["key1", "key2"] が出力される
+
+ +

Map の複製と混合

+ +

Array と同様に、 Map は複製することができます。

+ +
let original = new Map([
+  [1, 'one']
+])
+
+let clone = new Map(original)
+
+console.log(clone.get(1))       // one
+console.log(original === clone) // false (useful for shallow comparison)
+ +
+

重要: データ自身は複製されないことに注意しておいてください。

+
+ +

Map はキーの固有性を保持しながら混合可能です。

+ +
let first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+])
+
+let second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+])
+
+// 2つのマップを混合します。重複するキーは後勝ちになります。
+// スプレッド演算子は基本的に Map を Array に変換します。
+let merged = new Map([...first, ...second])
+
+console.log(merged.get(1)) // uno
+console.log(merged.get(2)) // dos
+console.log(merged.get(3)) // three
+ +

Map は Array と混合することもできます。

+ +
let first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+])
+
+let second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+])
+
+// マップと配列を混合します。重複するキーは後勝ちになります。
+let merged = new Map([...first, ...second, [1, 'eins']])
+
+console.log(merged.get(1)) // eins
+console.log(merged.get(2)) // dos
+console.log(merged.get(3)) // three
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..d63306551c --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,72 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

keys() メソッドは、 Map オブジェクトに挿入された要素のキーを挿入順に列挙する新しいイテレーターオブジェクトを返します。

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

構文

+ +
myMap.keys()
+ +

返値

+ +

{{jsxref("Map")}} の新しいイテレーターオブジェクト。

+ +

例

+ +

keys() の使用

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/map/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/map/index.html new file mode 100644 index 0000000000..863d4759e4 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/map/index.html @@ -0,0 +1,65 @@ +--- +title: Map() コンストラクター +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +tags: + - Constructor + - JavaScript + - Map + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map/Map +--- +
{{JSRef}}
+ +

Map() コンストラクターは、 {{jsxref("Map")}} オブジェクトを生成します。

+ +

構文

+ +
new Map([iterable])
+ +

引数

+ +
+
iterable
+
{{jsxref("Array")}} または他の反復処理可能なオブジェクトで、要素はキーと値の組です。 (たとえば、 [[ 1, 'one' ],[ 2, 'two' ]] のような2つの要素を持つ配列。) それぞれのそれぞれのキーと値の組が新しい Map に追加されます。
+
+ +

例

+ +

新しい Map の生成

+ +
let myMap = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+])
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..349c7a8776 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,88 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

set() メソッドは、指定されたキーと値を持つ要素を Map オブジェクトに追加したり、更新したりします。

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

構文

+ +
myMap.set(key, value)
+ +

引数

+ +
+
key
+
Map オブジェクトに追加する要素のキーです。
+
value
+
Map オブジェクトに追加する要素の値です。
+
+ +

返値

+ +

Mapオブジェクト。

+ +

例

+ +

set() の使用

+ +
let myMap = new Map()
+
+// マップに新しい要素を追加する
+myMap.set('bar', 'foo')
+myMap.set(1, 'foobar')
+
+// マップにある要素を更新する
+myMap.set('bar', 'baz')
+
+ +

set() のメソッドチェーンの使用

+ +

set() メソッドは Map オブジェクトを返すため、以下のようにメソッドチェーンを作ることができます。

+ +
// チェーンを使用してマップに新しい要素を追加する
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+
+ +

仕様書

+ + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..ba6111dd96 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,61 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

size アクセサープロパティは、 {{jsxref("Map")}} オブジェクトにある要素の数を返します。

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

解説

+ +

size の値は Map オブジェクトにいくつの項目があるかを表す整数値です。 size の set アクセサー関数は undefined です。このプロパティを変更することはできません。

+ +

例

+ +

size の使用

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

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/ja/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..560bc8d901 --- /dev/null +++ b/files/ja/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,71 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

values() メソッドは、 Map オブジェクトに挿入された要素を挿入順に列挙する新しいイテレーターオブジェクトを返します。

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

構文

+ +
myMap.values()
+ +

返値

+ +

{{jsxref("Map")}} の新しいイテレーターオブジェクト。

+ +

例

+ +

values() の使用

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}
+ +

ブラウザーの互換性

+ + + +

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

+ +

関連情報

+ + diff --git a/files/ja/web/api/node/getuserdata/index.html b/files/ja/web/api/node/getuserdata/index.html deleted file mode 100644 index 47fe7bfe05..0000000000 --- a/files/ja/web/api/node/getuserdata/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Node.getUserData() -slug: Web/API/Node/getUserData -tags: - - API - - DOM - - Method - - Node - - Obsolete - - Reference - - メソッド -translation_of: Web/API/Node/getUserData ---- -
{{APIRef("DOM")}}{{obsolete_header}}
- -

Node.getUserData() メソッドは、以前 {{domxref("Node.setUserData()")}} によってノードに設定されたすべてのユーザーデータを {{domxref("DOMUserData")}} 形式で返します。

- -
-

Node.setUserData および {{domxref("Node.getUserData")}} メソッドはウェブコンテンツから利用できなくなりました。 {{domxref("Element.dataset")}} または WeakMap を代わりに利用することができます。

-
- -

構文

- -
userData = someNode.getUserData(userKey);
- -

引数

- - - -

例

- -
var d = document.setUserData('key', 15, null);
-console.log(document.getUserData('key')); // 15
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}初回定義
- -

ブラウザーの互換性

- - - -

{{Compat("api.Node.getUserData")}}

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/ja/web/javascript/reference/global_objects/map/@@iterator/index.html deleted file mode 100644 index 961f7acd85..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/@@iterator/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: 'Map.prototype[@@iterator]()' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator ---- -
{{JSRef}}
- -

@@iterator プロパティの初期値は、 {{jsxref("Map.prototype.entries()", "entries")}} メソッドの初期値と同じ関数オブジェクトです。

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

構文

- -
myMap[Symbol.iterator]
- -

返値

- -

マップの iterator 関数で、既定では {{jsxref("Map.prototype.entries()", "entries()")}} 関数です。

- -

例

- -

[@@iterator]() の使用

- -
const myMap = new Map()
-myMap.set('0', 'foo')
-myMap.set(1, 'bar')
-myMap.set({}, 'baz')
-
-const mapIter = myMap[Symbol.iterator]()
-
-console.log(mapIter.next().value) // ["0", "foo"]
-console.log(mapIter.next().value) // [1, "bar"]
-console.log(mapIter.next().value) // [Object, "baz"]
-
- -

[@@iterator]() と for..of の併用

- -
const myMap = new Map()
-myMap.set('0', 'foo')
-myMap.set(1, 'bar')
-myMap.set({}, 'baz')
-
-for (const entry of myMap) {
-  console.log(entry)
-}
-// ["0", "foo"]
-// [1, "bar"]
-// [{}, "baz"]
-
-for (const [key, value] of myMap) {
-  console.log(`${key}: ${value}`)
-}
-// 0: foo
-// 1: bar
-// [Object]: baz
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/@@species/index.html b/files/ja/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index 4a428acdad..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: 'get Map[@@species]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@species -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -
{{JSRef}}
- -

Map[@@species] アクセサープロパティは、 Map コンストラクターを返します。

- -

解説

- -

species アクセサープロパティは Map オブジェクトのデフォルトコンストラクターを返します。サブクラスのコンストラクターは、コンストラクターに代入して変更することによりオーバーライドすることができます。

- -

例

- -

通常のオブジェクトの species

- -

species プロパティはデフォルトコンストラクター関数を返しますので、 Map オブジェクトには Map コンストラクターを返します。

- -
Map[Symbol.species]; // function Map()
- -

派生オブジェクトの species

- -

派生したコレクションオブジェクトの中では (例えばカスタムマップである MyMap)、 MyMap の species は MyMap コンストラクターになっています。しかし、これをオーバーライドして、派生クラスのメソッド内で親の Map オブジェクトを返したい場合があります。

- -
class MyMap extends Map {
-  // Overwrite MyMap species to the parent Map constructor
-  static get [Symbol.species]() { return Map; }
-}
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}
- -

ブラウザーの互換性

- -
- - -

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

-
- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/ja/web/javascript/reference/global_objects/map/@@tostringtag/index.html deleted file mode 100644 index 74da140e51..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: 'Map.prototype[@@toStringTag]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property - - Prototype - - Reference - - プロパティ -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag ---- -
{{JSRef}}
- -

Map[@@toStringTag] プロパティは、 "Map" の初期値を持ちます。

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

構文

- -
Map[Symbol.toStringTag]
- -

例

- -

toStringTag の使用

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

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/clear/index.html b/files/ja/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 266ab6f9fe..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

clear() メソッドは Map オブジェクトからすべての要素を削除します。

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

構文

- -
myMap.clear();
-
- -

返値

- -

{{jsxref("undefined")}}.

- -

例

- -

clear() の使用

- -
var myMap = new Map();
-myMap.set('bar', 'baz');
-myMap.set(1, 'foo');
-
-myMap.size;       // 2
-myMap.has('bar'); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has('bar')  // false
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/delete/index.html b/files/ja/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 30dcc4c848..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

delete() メソッドは Map オブジェクトから特定の要素を削除します。

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

構文

- -
myMap.delete(key);
- -

引数

- -
-
key
-
Map オブジェクトから削除する要素のキーです。
-
- -

返値

- -

Map オブジェクトの要素が削除されたら true を、要素が存在しなければ false を返します。

- -

例

- -

delete() メソッドの使用

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.delete('bar'); // 正常に削除出来れば true を返す
-myMap.has('bar');    // 存在しない要素を確認すると false を返す
-
- -

仕様書

- - - - - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/entries/index.html b/files/ja/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index fd4710ebf5..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

entries() メソッドは、挿入順で Map オブジェクトの要素に対する [key, value] ペアを含む新しい Iterator オブジェクトを返します。

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

構文

- -
myMap.entries()
- -

返値

- -

新しい {{jsxref("Map")}} の反復子オブジェクトです。

- -

例

- -

entries() の使用

- -
let myMap = new Map()
-myMap.set('0', 'foo')
-myMap.set(1, 'bar')
-myMap.set({}, 'baz')
-
-let mapIter = myMap.entries()
-
-console.log(mapIter.next().value)  // ["0", "foo"]
-console.log(mapIter.next().value)  // [1, "bar"]
-console.log(mapIter.next().value)  // [Object, "baz"]
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/foreach/index.html b/files/ja/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index 9685b460bd..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

forEach() メソッドは、指定された関数を Map オブジェクト内にあるキーと値のペアそれぞれに対して1回ずつ、挿入順に実行します。

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

構文

- -
myMap.forEach(callback([value][, key][, map])[, thisArg])
- -

引数

- -
-
callback
-
-

myMap のそれぞれの項目に対して実行される関数。以下の引数を取ります。

- -
-
value {{Optional_Inline}}
-
それぞれの反復処理における値です。
-
key {{Optional_Inline}}
-
それぞれの反復処理におけるキーです。
-
map {{Optional_Inline}}
-
反復処理されるマップです (上記の構文ボックスでは myMap です)。
-
-
-
thisArg {{Optional_Inline}}
-
callback の実行時に this として使用される値です。
-
- -

返値

- -

{{jsxref("undefined")}} です。

- -

解説

- -

forEach メソッドは、指定された関数 callback を、マップの実在するそれぞれのキーに対して一度ずつ呼び出します。これは削除されたキーに対しては呼び出しません。ただし、存在していて undefined である値に対しては呼び出します。

- -

callback は次の 3 つの引数で呼び出されます。

- - - -

thisArg 引数が forEach に指定されると、 callback の呼び出し時にそのオブジェクトが this の値として使用されます。与えられなかった場合は、 undefined が this の値として渡されます。 callback によって究極に管理される this の値は、関数から見える this を特定する一般規則に従います。

- -

それぞれの値に対して一度ずつ実行されますが、 forEach が終了するまでに削除され再追加された場合は除きます。 callback はその前に削除された値に対しては実行されません。 forEach が終了する前に追加された新しい値に対しては実行されます。

- -

例

- -

Map オブジェクトの内容を表示

- -

以下のコードは Map オブジェクト内の各要素を1行ずつ出力します。

- -
function logMapElements(value, key, map) {
-    console.log(`map.get('${key}') = ${value}`)
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements)
-// logs:
-// "map.get('foo') = 3"
-// "map.get('bar') = [object Object]"
-// "map.get('baz') = undefined"
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/get/index.html b/files/ja/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 6b2a330995..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

get() メソッドは、指定された要素を Map オブジェクトから返します。指定されたキーに関連付けられた値がオブジェクトである場合は、そのオブジェクトの参照を受け取ることになり、そのオブジェクトに対して変更を行った場合は、 Map オブジェクトの中にあるものに変更が行われます。

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

構文

- -
myMap.get(key)
- -

引数

- -
-
key
-
Map オブジェクトから返される要素のキーです。
-
- -

返値

- -

指定されたキーに関連付けられた要素が返されます。 Map オブジェクト内にキーが見つからない場合は、 undefined を返されます。

- -

例

- -

Using get()

- -
let myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');   // "foo" を返す
-myMap.get('baz');   // undefined を返す
-
- -

仕様書

- - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/has/index.html b/files/ja/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 5aed70a252..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

has() メソッドは、指定されたキーに対する要素が存在するかどうかを示す論理値を返します。

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

構文

- -
myMap.has(key)
- -

引数

- -
-
key
-
Map オブジェクト内に存在するかテストするための要素のキーです。
-
- -

返値

- -

特定のキーに対する要素が Map オブジェクト内に存在していたら、true を返します。さもなければ、false を返します。

- -

例

- -

has() の使用

- -
let myMap = new Map()
-myMap.set('bar', "foo")
-
-myMap.has('bar')   // returns true
-myMap.has('baz')   // returns false
-
- -

仕様書

- - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/index.html b/files/ja/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 87298d6f3f..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,369 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - Class - - ECMAScript 2015 - - JavaScript - - Map - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -

Map オブジェクトはキーと値のペアを保持し、キーが最初に挿入された順序を覚えています。キーや値には任意の値 (オブジェクトと{{glossary("Primitive", "プリミティブ値")}})を使用することができます。

- -

解説

- -

Map オブジェクトは、その要素について挿入順で反復処理を行うことができます。 {{jsxref("Statements/for...of", "for...of")}} ループは各反復で [キー, 値] の配列を返します。

- -

キーの等価性

- - - -

Object と Map の比較

- -

{{jsxref("Object")}} と Map は似ています。 — どちらもキーを値に設定したり、それらの値を受け取ったり、キーを削除したり、キーに何かが格納されているかどうかを判定したりすることができます。この意味で (そして他の内蔵オブジェクトがなかったため)、従来 Object は Map として使われてきました。

- -

しかし、いくつかの場面で Map の方が勝るような重要な違いがあります。

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MapObject
思いがけないキーMap は既定では何もキーを持っていません。明示的に設定したものだけを含みます。 -

Object にはプロトタイプがあります。よって既定のキーを含んでいるので、注意しないと自分のキーと衝突する可能性があります。

- -
-

注: ES5 では、 {{jsxref("Object.create", "Object.create(null)")}} を使用すると回避できますが、これはめったに行われていません。

-
-
キーの型Map のキーはあらゆる値がなることができます (関数、オブジェクト、あらゆるプリミティブなど)。Object のキーは {{jsxref("String")}} または {{jsxref("Symbol")}} でなければなりません。
キーの順序 -

Map のキーは、単純で直感的な方法で順序付けられます。すなわち、反復処理を行うと、 Map オブジェクトは挿入順でキーを返します。

- 		-

通常の Object のキーは現在では順序付けされていますが、以前はそうではなかったので、順序は複雑です。結果として、プロパティの順序に頼らない方が良いでしょう。

- -

この順序は ECMAScript 2015 で初めて自身のプロパティに対してのみ定義されましたが、 ECMAScript 2020 では継承されたプロパティに対しても同様に順序が定義されています。 OrdinaryOwnPropertyKeys と EnumerateObjectProperties の抽象指定操作を参照してください。しかし、オブジェクトのプロパティがすべて反復処理される単一の単一のメカニズムはないことに注意してください。 ({{jsxref("Statements/for...in", "for-in")}} は列挙可能な文字列キーのプロパティのみを含む、 {{jsxref("Object.keys")}} は自分自身の列挙可能な文字列キーのプロパティのみを含む、 {{jsxref("Object.getOwnPropertyNames")}} は列挙不可能な場合でも自分自身の文字列キーのプロパティを含む、 {{jsxref("Object.getOwnPropertySymbols")}} は、 Symbol キーを持つプロパティに対しても同じことを行う、など。)

-
-

大きさ

- 		Map の中の項目数は、 {{jsxref("Map.prototype.size", "size")}} プロパティで簡単に得ることができます。 property.Object の中の項目数は、手動で数える必要があります。
反復処理Map は iterable ですので、直接反復処理を行うことができます。Object では反復処理を行うのに、いくつかの形でキーの一覧を取得して、そのうえで反復処理を行う必要があります。
性能 -

キーと値の組を頻繁に追加したり削除したりすることが求められるシナリオでは、性能がより良くなります。

- 		-

キーと値の組を頻繁に追加したり削除したりすることに最適化されていません。

-
- -

オブジェクトプロパティの設定

- -

Map オブジェクトに対してオブジェクトプロパティを設定すると正しく動作しますが、混乱を催すことが考えられます。

- -

たとえば、次の例は一応動作するように見えます。

- -
let wrongMap = new Map()
-wrongMap['bla'] = 'blaa'
-wrongMap['bla2'] = 'blaaa2'
-
-console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
-
- -

しかし、このようにプロパティを設定すると、 Map データ構造に符合しません。一般的なオブジェクトの機能を使用します。 'bla' の値はクエリを行うための Map に格納されません。データにその他の操作を行うと失敗します。

- -
wrongMap.has('bla')    // false
-wrongMap.delete('bla') // false
-console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
- -

Map にデータを格納する正しい方法は、 set(key, value) メソッドを使用する方法です。

- -
let contacts = new Map()
-contacts.set('Jessie', {phone: "213-555-1234", address: "123 N 1st Ave"})
-contacts.has('Jessie') // true
-contacts.get('Hilary') // undefined
-contacts.set('Hilary', {phone: "617-555-4321", address: "321 S 2nd St"})
-contacts.get('Jessie') // {phone: "213-555-1234", address: "123 N 1st Ave"}
-contacts.delete('Raymond') // false
-contacts.delete('Jessie') // true
-console.log(contacts.size) // 1
-
-
- -

コンストラクター

- -
-
{{jsxref("Map/Map", "Map()")}}
-
新しい Map オブジェクトを生成します。
-
- -

静的プロパティ

- -
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
派生クラスを生成するためのコンストラクター関数です。
-
- -

インスタンスプロパティ

- -
-
{{jsxref("Map.prototype.size")}}
-
Map オブジェクトの中のキーと値の組の数を返します。
-
- -

インスタンスメソッド

- -
-
{{jsxref("Map.prototype.clear()")}}
-
Mapオブジェクトからすべてのキーと値の組を削除します。
-
{{jsxref("Map.delete", "Map.prototype.delete(key)")}}
-
Map オブジェクトに要素が存在し、削除された場合は true を返します、要素が存在しなければ false を返します。その後では Map.prototype.has(key) が false を返すようになります。
-
{{jsxref("Map.get", "Map.prototype.get(key)")}}
-
key で指定されたキーに結び付けられた値を返します。存在しない場合は undefined を返します。
-
{{jsxref("Map.has", "Map.prototype.has(key)")}}
-
key で指定されたキーに結び付けられた要素が Map オブジェクト内に存在するかどうかを示す boolean を返します。
-
{{jsxref("Map.set", "Map.prototype.set(key, value)")}}
-
Map オブジェクト内の key で指定されたキーの値を value に設定します。その Map オブジェクトを返します。
-
- -

反復処理メソッド

- -
-
{{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}
-
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素の [key, value] の配列が挿入順で含まれます。
-
{{jsxref("Map.prototype.keys()")}}
-
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素のキーが挿入順で含まれます。
-
{{jsxref("Map.prototype.values()")}}
-
新しいイテレーターオブジェクトを返し、これには Mapオブジェクト内の各要素の値が挿入順で含まれます。
-
{{jsxref("Map.prototype.entries()")}}
-
Mapオブジェクト内の要素に対して挿入順にすべての要素の [key, value] の配列を含む、新しいイテレーターオブジェクトを返します。
-
{{jsxref("Map.forEach", "Map.prototype.forEach(callbackFn[, thisArg])")}}
-
callbackFn を、 Map オブジェクトに存在するそれぞれのキーと値の組に対して1回ずつ、挿入順に呼び出します。 thisArg 引数が forEach に与えられた場合は、それぞれのコールバックでこれを this の値として使用します。
-
- -

例

- -

Map オブジェクトの使用

- -
let myMap = new Map()
-
-let keyString = '文字列'
-let keyObj    = {}
-let keyFunc   = function() {}
-
-// 値を設定する
-myMap.set(keyString, "'文字列' と結び付けられた値")
-myMap.set(keyObj, "keyObj と結び付けられた値")
-myMap.set(keyFunc, "keyFunc と結び付けられた値")
-
-myMap.size              // 3
-
-// 値を取得する
-myMap.get(keyString)    // "'文字列' と結び付けられた値"
-myMap.get(keyObj)       // "keyObj と結び付けられた値"
-myMap.get(keyFunc)      // "keyFunc と結び付けられた値"
-
-myMap.get('文字列')     // "'文字列' と結び付けられた値"
-                        // keyString === '文字列' であるため
-myMap.get({})           // undefined, keyObj !== {} であるため
-myMap.get(function() {}) // undefined, keyFunc !== function () {} であるため
-
- -

NaN を Map のキーとして使用

- -

{{jsxref("NaN")}} もまたキーとして使うことができます。すべての NaN は自身と等しくない (NaN !== NaN は真) にもかかわらず、以下の例は動作します。これは NaN が互いに区別できないためです。

- -
let myMap = new Map()
-myMap.set(NaN, 'not a number')
-
-myMap.get(NaN)
-// "not a number"
-
-let otherNaN = Number('foo')
-myMap.get(otherNaN)
-// "not a number"
-
- -

for..of を使用した Map の反復処理

- -

Map は for..of ループを使用して反復処理を行うことができます。

- -
let myMap = new Map()
-myMap.set(0, 'zero')
-myMap.set(1, 'one')
-
-for (let [key, value] of myMap) {
-  console.log(key + ' = ' + value)
-}
-// 0 = zero
-// 1 = one
-
-for (let key of myMap.keys()) {
-  console.log(key)
-}
-// 0
-// 1
-
-for (let value of myMap.values()) {
-  console.log(value)
-}
-// zero
-// one
-
-for (let [key, value] of myMap.entries()) {
-  console.log(key + ' = ' + value)
-}
-// 0 = zero
-// 1 = one
-
- -

forEach() で Map を反復処理

- -

Map は {{jsxref("Map.prototype.forEach", "forEach()")}} メソッドを使用して反復できます。

- -
myMap.forEach(function(value, key) {
-  console.log(key + ' = ' + value)
-})
-// 0 = zero
-// 1 = one
-
- -

Array オブジェクトとの関係

- -
let kvArray = [["キー1", "値1"], ["キー2", "値2"]];
-
-// 通常の Map コンストラクターを使って、キー・値の 2 次元配列をマップに変換する
-let myMap = new Map(kvArray)
-
-myMap.get("キー1") // "値1" を返す
-
-// 展開演算子を使って、マップをキー・値の 2 次元配列に変換する
-console.log(Array.from(myMap)) // kvArray とまったく同じ Array を表示する
-
-// あるいは展開演算子をキーまたは値のイテレーターに使って、キーまたは値のみの配列を得る
-console.log([...myMap])
-
-// または keys() や values() のイテレーターを使用して配列に変換する
-console.log(Array.from(myMap.keys())) // ["key1", "key2"] が出力される
-
- -

Map の複製と混合

- -

Array と同様に、 Map は複製することができます。

- -
let original = new Map([
-  [1, 'one']
-])
-
-let clone = new Map(original)
-
-console.log(clone.get(1))       // one
-console.log(original === clone) // false (useful for shallow comparison)
- -
-

重要: データ自身は複製されないことに注意しておいてください。

-
- -

Map はキーの固有性を保持しながら混合可能です。

- -
let first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-])
-
-let second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-])
-
-// 2つのマップを混合します。重複するキーは後勝ちになります。
-// スプレッド演算子は基本的に Map を Array に変換します。
-let merged = new Map([...first, ...second])
-
-console.log(merged.get(1)) // uno
-console.log(merged.get(2)) // dos
-console.log(merged.get(3)) // three
- -

Map は Array と混合することもできます。

- -
let first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-])
-
-let second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-])
-
-// マップと配列を混合します。重複するキーは後勝ちになります。
-let merged = new Map([...first, ...second, [1, 'eins']])
-
-console.log(merged.get(1)) // eins
-console.log(merged.get(2)) // dos
-console.log(merged.get(3)) // three
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/keys/index.html b/files/ja/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index d4ce212d2d..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{JSRef}}
- -

keys() メソッドは、 Map オブジェクトに挿入された要素のキーを挿入順に列挙する新しいイテレーターオブジェクトを返します。

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

構文

- -
myMap.keys()
- -

返値

- -

{{jsxref("Map")}} の新しいイテレーターオブジェクト。

- -

例

- -

keys() の使用

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/map/index.html b/files/ja/web/javascript/reference/global_objects/map/map/index.html deleted file mode 100644 index 91aaf5520a..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/map/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Map() コンストラクター -slug: Web/JavaScript/Reference/Global_Objects/Map/Map -tags: - - Constructor - - JavaScript - - Map - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map ---- -
{{JSRef}}
- -

Map() コンストラクターは、 {{jsxref("Map")}} オブジェクトを生成します。

- -

構文

- -
new Map([iterable])
- -

引数

- -
-
iterable
-
{{jsxref("Array")}} または他の反復処理可能なオブジェクトで、要素はキーと値の組です。 (たとえば、 [[ 1, 'one' ],[ 2, 'two' ]] のような2つの要素を持つ配列。) それぞれのそれぞれのキーと値の組が新しい Map に追加されます。
-
- -

例

- -

新しい Map の生成

- -
let myMap = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-])
-
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/set/index.html b/files/ja/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 7793857adb..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

set() メソッドは、指定されたキーと値を持つ要素を Map オブジェクトに追加したり、更新したりします。

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

構文

- -
myMap.set(key, value)
- -

引数

- -
-
key
-
Map オブジェクトに追加する要素のキーです。
-
value
-
Map オブジェクトに追加する要素の値です。
-
- -

返値

- -

Mapオブジェクト。

- -

例

- -

set() の使用

- -
let myMap = new Map()
-
-// マップに新しい要素を追加する
-myMap.set('bar', 'foo')
-myMap.set(1, 'foobar')
-
-// マップにある要素を更新する
-myMap.set('bar', 'baz')
-
- -

set() のメソッドチェーンの使用

- -

set() メソッドは Map オブジェクトを返すため、以下のようにメソッドチェーンを作ることができます。

- -
// チェーンを使用してマップに新しい要素を追加する
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
-
- -

仕様書

- - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/size/index.html b/files/ja/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index a65d7f6edc..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

size アクセサープロパティは、 {{jsxref("Map")}} オブジェクトにある要素の数を返します。

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

解説

- -

size の値は Map オブジェクトにいくつの項目があるかを表す整数値です。 size の set アクセサー関数は undefined です。このプロパティを変更することはできません。

- -

例

- -

size の使用

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

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ja/web/javascript/reference/global_objects/map/values/index.html b/files/ja/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index baabf38459..0000000000 --- a/files/ja/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
{{JSRef}}
- -

values() メソッドは、 Map オブジェクトに挿入された要素を挿入順に列挙する新しいイテレーターオブジェクトを返します。

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

構文

- -
myMap.values()
- -

返値

- -

{{jsxref("Map")}} の新しいイテレーターオブジェクト。

- -

例

- -

values() の使用

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

仕様書

- - - - - - - - - - - - -
仕様書
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}
- -

ブラウザーの互換性

- - - -

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

- -

関連情報

- - diff --git a/files/ko/_redirects.txt b/files/ko/_redirects.txt index 553de85540..1fe2ad8283 100644 --- a/files/ko/_redirects.txt +++ b/files/ko/_redirects.txt @@ -905,7 +905,18 @@ /ko/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype /ko/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ko/docs/Web/JavaScript/Reference/Global_Objects/Locale /ko/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale /ko/docs/Web/JavaScript/Reference/Global_Objects/Locale/language /ko/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/language +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/Map /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/get /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/has /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has /ko/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /ko/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/set /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/ko/docs/Web/JavaScript/Reference/Global_Objects/Map/size /ko/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size /ko/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /ko/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /ko/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /ko/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ko/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/prototype /ko/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat diff --git a/files/ko/_wikihistory.json b/files/ko/_wikihistory.json index 558ad013c9..c42f09fe2c 100644 --- a/files/ko/_wikihistory.json +++ b/files/ko/_wikihistory.json @@ -14219,78 +14219,6 @@ "supermanWannaBe" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:50:09.238Z", - "contributors": [ - "Chloe-HyunJoo", - "alattalatta", - "younghoh", - "KaironMoon", - "echo304", - "dragmove" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { - "modified": "2020-10-15T22:04:19.848Z", - "contributors": [ - "Seok.Heo" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/Map": { - "modified": "2020-10-15T22:26:33.491Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-10-15T22:09:01.449Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T22:09:03.155Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2020-10-15T22:09:02.936Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T22:20:31.940Z", - "contributors": [ - "JaeWorld" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T22:15:40.628Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T22:15:44.379Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-15T22:15:44.384Z", - "contributors": [ - "alattalatta" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-10-15T22:04:26.274Z", - "contributors": [ - "Gren", - "Seok.Heo" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:38:50.083Z", "contributors": [ @@ -18609,6 +18537,78 @@ "alattalatta" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:50:09.238Z", + "contributors": [ + "Chloe-HyunJoo", + "alattalatta", + "younghoh", + "KaironMoon", + "echo304", + "dragmove" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { + "modified": "2020-10-15T22:04:19.848Z", + "contributors": [ + "Seok.Heo" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map": { + "modified": "2020-10-15T22:26:33.491Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-10-15T22:09:01.449Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T22:09:03.155Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2020-10-15T22:09:02.936Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T22:20:31.940Z", + "contributors": [ + "JaeWorld" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T22:15:40.628Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T22:15:44.379Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-15T22:15:44.384Z", + "contributors": [ + "alattalatta" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-10-15T22:04:26.274Z", + "contributors": [ + "Gren", + "Seok.Heo" + ] + }, "orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator": { "modified": "2020-10-15T22:15:31.566Z", "contributors": [ diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html new file mode 100644 index 0000000000..c3bc792458 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,52 @@ +--- +title: Map.prototype[@@toStringTag] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +--- +
{{JSRef}}
+ +

Map[@@toStringTag] 프로퍼티의 초기값은 "Map"입니다.

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

문법

+ +
Map[Symbol.toStringTag]
+ +

예제

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

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..292c68789c --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,76 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

clear() 메서드는 Map 객체의 모든 요소를 제거합니다.

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

구문

+ +
myMap.clear();
+
+ +

예제

+ +

clear() 사용하기

+ +
var myMap = new Map();
+myMap.set('bar', 'baz');
+myMap.set(1, 'foo');
+
+myMap.size;       // 2
+myMap.has('bar'); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has('bar')  // false
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

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

delete() 메서드는 Map 객체에서 특정 요소를 제거합니다.

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

구문

+ +
myMap.delete(key);
+ +

매개변수

+ +
+
key
+
Map 객체에서 제거할 요소의 키.
+
+ +

반환 값

+ +

요소가 Map 객체에 존재해서 제거했을 경우 true, 존재하지 않았으면 false.

+ +

예제

+ +

delete() 사용하기

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.delete('bar'); // Returns true. Successfully removed.
+myMap.has('bar');    // Returns false. The "bar" element is no longer present.
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..202115e2d6 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,79 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

entries() 메서드는 Map 객체의 각 요소에 해당하는 [키, 값] 쌍을 Map에 등록한 순서대로 포함한 새로운 Iterator 객체를 반환합니다.

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

구문

+ +
myMap.entries()
+ +

반환 값

+ +

A new {{jsxref("Map")}} iterator object.

+ +

예제

+ +

entries() 사용하기

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..b26b7c7d37 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,99 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

forEach() 메소드는 Map 오브젝트 내의 key/value 쌍의 개수 만큼 주어진 함수를 순서대로 실행합니다. 

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

문법

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

파라미터

+ +
+
callback
+
각각의 요소를 처리하기 위한 함수.
+
thisArg
+
 callback 을 실행할때 this 로 사용되는 값.
+
+ +

Return value

+ +

{{jsxref("undefined")}}.

+ +

설명

+ +

forEach 메서드는 map의 각각의 키마다 주어진 callback 함수를 실행합니다. 삭제된 키에대해서는 호출되지 않습니다. 그러나, 값이 존재하지만 undefined 인 값에 대해서는 실행됩니다.

+ +

callback 은 3가지 인수로 호출됩니다.

+ + + +

thisArg 파라미터가 forEach 에 제공되면, this 값으로 사용하기 위해 호출될때 callback 으로 넘겨집니다. 그렇지 않으면 undefined 값이 this 값으로 넘겨질 것입니다. 궁극적으로 callback 으로 보여지게 된 this 값은 함수에 의해 보여지는 this 를 결정하기 위한 일반적인 규칙에 따라 결정됩니다.

+ +

각각의 value는 한번씩 사용됩니다. 다만 forEach 가 끝나기 전에 value가 삭제되거나 재추가 된 경우는 예외입니다. callback 은 사용되기 전에 삭제된 value에 의해 호출되지 않습니다. forEach 가 끝나기 전에 새롭게 추가된 value가 사용 됩니다.

+ +

forEach 는 Map 오브젝트 내에 있는 각각의 요소마다 callback 함수를 실행합니다; 깂을 반환하지 않습니다.

+ +

예제

+ +

Map 오브젝트의 내용을 출력

+ +

아래의 코드는 Map 오브젝트 내의 각각 요소들을 행별로 출력합니다:

+ +
function logMapElements(value, key, map) {
+    console.log(`map.get('${key}') = ${value}`);
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
+// logs:
+// "map.get('foo') = 3"
+// "map.get('bar') = [object Object]"
+// "map.get('baz') = undefined"
+
+ +

Specifications

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
+ +

Browser compatibility

+ + + +

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

+ +

See also

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..7fbd5c19f3 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,81 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

get() 메서드는 Map 객체에서 지정한 요소를 회수합니다.

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

구문

+ +
myMap.get(key);
+ +

매개변수

+ +
+
key
+
Map 객체에서 회수할 요소의 키.
+
+ +

반환 값

+ +

주어진 키와 연결된 요소. 그런 요소가 없으면 {{jsxref("undefined")}}.

+ +

예제

+ +

get 사용하기

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');  // "foo" 반환.
+myMap.get('baz');  // undefined 반환.
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..8f3d1c475e --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,82 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

has() 메서드는 주어진 키를 가진 요소가 Map에 존재하는지를 반환합니다.

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

구문

+ +
myMap.has(key);
+ +

매개변수

+ +
+
key
+
존재 여부를 판별할 키값.
+
+ +

반환 값

+ +

주어진 키를 가진 요소가 있으면 true, 아니면 false.

+ +

예제

+ +

has() 사용하기

+ +
var myMap = new Map();
+myMap.set('bar', "foo");
+
+myMap.has('bar');  // returns true
+myMap.has('baz');  // returns false
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..32a5de42f7 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,245 @@ +--- +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}}
+ +

Map 객체는 키-값 쌍을 저장하며 각 쌍의 삽입 순서도 기억하는 콜렉션입니다. 아무 값(객체와 {{Glossary("Primitive", "원시 값")}})이라도 키와 값으로 사용할 수 있습니다.

+ +

설명

+ +

Map 객체는 요소의 삽입 순서대로 원소를 순회합니다. {{jsxref("Statements/for...of", "for...of")}} 반복문은 각 순회에서 [key, value]로 이루어진 배열을 반환합니다.

+ +

키 동일성

+ + + +

{{jsxref("Object")}}와 Map 비교

+ +

{{jsxref("Object")}}는 값에 키를 할당할 수 있고, 그 키로 값을 얻을 수 있고, 키를 삭제할 수 있으며 어떤 키에 값이 존재하는지 확인할 수 있다는 점에서 Map과 유사합니다. 이런 이유에 더해, 이전에는 내장된 대체제가 없었기 때문에, Object를 Map 대신 사용하곤 했습니다.

+ +

그러나 어떤 상황에선, Map을 선호해야 할 몇 가지 중요한 차이점이 있습니다.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MapObject
의도치 않은 키Map은 명시적으로 제공한 키 외에는 어떤 키도 가지지 않습니다. +

Object는 프로토타입을 가지므로 기본 키가 존재할 수 있습니다. 주의하지 않으면 직접 제공한 키와 충돌할 수도 있습니다.

+ +
+

참고: ES5부터, 프로토타입으로 인한 키 충돌은 {{jsxref("Object.create", "Object.create(null)")}}로 해결할 수 있지만, 실제로 쓰이는 경우는 적습니다.

+
+
키 자료형Map의 키는 함수, 객체 등을 포함한 모든 값이 가능합니다.Object의 키는 반드시 {{jsxref("String")}} 또는 {{jsxref("Symbol")}}이어야 합니다.
키 순서 +

Map의 키는 정렬됩니다. 따라서 Map의 순회는 삽입순으로 이뤄집니다.

+ 		+

Object의 키는 정렬되지 않습니다.

+ +
+

참고: ECMAScript 201 이후로, 객체도 문자열과 Symbol 키의 생성 순서를 유지합니다. ECMEScript 2015 명세를 준수하는 JavaScript 엔진에서 문자열 키만 가진 객체를 순회하면 삽입 순을 따라갑니다.

+
+
크기Map의 항목 수는 {{jsxref("Map.prototype.size", "size")}} 속성을 통해 쉽게 알아낼 수 있습니다.Object의 항목 수는 직접 알아내야 합니다.
순회Map은 순회 가능하므로, 바로 순회할 수 있습니다.Object를 순회하려면 먼저 모든 키를 알아낸 후, 그 키의 배열을 순회해야 합니다.
성능잦은 키-값 쌍의 추가와 제거에서 더 좋은 성능을 보입니다.잦은 키-값 쌍의 추가와 제거를 위한 최적화가 없습니다.
+ +

생성자

+ +
+
{{jsxref("Map.Map", "Map()")}}
+
새로운 Map 객체를 생성합니다.
+
+ +

속성

+ +
+
Map.length
+
값이 0인 속성입니다.
+ 요소의 수는 {{jsxref("Map.prototype.size")}}로 알아낼 수 있습니다.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
파생 객체를 생성하는데 사용하는 생성자 함수입니다.
+
{{jsxref("Map.prototype")}}
+
Map 생성자의 프로토타입을 나타냅니다. 모든 Map 인스턴스에 속성을 추가할 수 있습니다.
+
+ +

Map 인스턴스

+ +

모든 Map 인스턴스는 {{jsxref("Map.prototype")}}을 상속합니다.

+ +

속성

+ +

{{page('ko/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

+ +

메서드

+ +

{{page('ko/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

+ +

예제

+ +

Map 객체 사용하기

+ +
let myMap = new Map()
+
+let keyString = '문자열'
+let keyObj    = {}
+let keyFunc   = function() {}
+
+// 값 설정
+myMap.set(keyString, "'문자열'과 관련된 값")
+myMap.set(keyObj, 'keyObj와 관련된 값')
+myMap.set(keyFunc, 'keyFunc와 관련된 값')
+
+myMap.size              // 3
+
+// getting the values
+myMap.get(keyString)    // "'문자열'과 관련된 값"
+myMap.get(keyObj)       // "keyObj와 관련된 값"
+myMap.get(keyFunc)      // "keyFunc와 관련된 값"
+
+myMap.get('문자열')    // "'문자열'과 관련된 값"
+                         // keyString === '문자열'이기 때문
+myMap.get({})            // undefined, keyObj !== {}
+myMap.get(function() {}) // undefined, keyFunc !== function () {}
+ +

Map의 키로 NaN 사용하기

+ +

{{jsxref("NaN")}}도 키로서 사용할 수 있습니다. 모든 NaN은 자기 자신과 동일하지 않지만(NaN !== NaN), NaN을 서로 구분할 수도 없기 때문에 아래 예제도 잘 동작합니다.

+ +
let myMap = new Map()
+myMap.set(NaN, 'not a number')
+
+myMap.get(NaN)
+// "not a number"
+
+let otherNaN = Number('foo')
+myMap.get(otherNaN)
+// "not a number"
+ +

for..of로 Map 순회하기

+ +

Map은 for..of 반복문을 사용해 순회할 수 있습니다.

+ +
let myMap = new Map()
+myMap.set(0, 'zero')
+myMap.set(1, 'one')
+
+for (let [key, value] of myMap) {
+  console.log(key + ' = ' + value)
+}
+// 0 = zero
+// 1 = one
+
+for (let key of myMap.keys()) {
+  console.log(key)
+}
+// 0
+// 1
+
+for (let value of myMap.values()) {
+  console.log(value)
+}
+// zero
+// one
+
+for (let [key, value] of myMap.entries()) {
+  console.log(key + ' = ' + value)
+}
+// 0 = zero
+// 1 = one
+ +

forEach()로 Map 순회하기

+ +

Map은 {{jsxref("Map.prototype.forEach", "forEach()")}} 메서드로 순회할 수 있습니다.

+ +
myMap.forEach(function(value, key) {
+  console.log(key + ' = ' + value)
+})
+// 0 = zero
+// 1 = one
+ +

Array 객체와의 관계

+ +
let kvArray = [['key1', 'value1'], ['key2', 'value2']]
+
+// Use the regular Map constructor to transform a 2D key-value Array into a map
+let myMap = new Map(kvArray)
+
+myMap.get('key1') // returns "value1"
+
+// Use Array.from() to transform a map into a 2D key-value Array
+console.log(Array.from(myMap)) // Will show you exactly the same Array as kvArray
+
+// A succinct way to do the same, using the spread syntax
+console.log([...myMap])
+
+// Or use the keys() or values() iterators, and convert them to an array
+console.log(Array.from(myMap.keys())) // ["key1", "key2"]
+ +

명세

+ + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
+ +

브라우저 호환성

+ +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/map/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/map/index.html new file mode 100644 index 0000000000..8a384863bd --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/map/index.html @@ -0,0 +1,61 @@ +--- +title: Map() 생성자 +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +tags: + - Constructor + - JavaScript + - Map + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map/Map +--- +
{{JSRef}}
+ +

Map() 생성자는 {{jsxref("Map")}} 객체를 생성합니다.

+ +

구문

+ +
new Map([iterable])
+ +

매개변수

+ +
+
iterable
+
요소가 키-값 쌍인, {{jsxref("Array")}} 또는 다른 순회 가능한 객체(예: [[1, 'one'], [2, 'two']]). 각 키-값 쌍은 새로운 Map에 포함됩니다.
+
+ +

예제

+ +
let myMap = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+])
+
+ +

명세

+ + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..8a8907a278 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,97 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

set() 메서드는 Map 객체에서 주어진 키를 가진 요소를 추가하고, 키의 요소가 이미 있다면 대체합니다.

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

구문

+ +
myMap.set(key, value);
+ +

매개변수

+ +
+
key
+
Map에 추가하거나 변경할 요소의 키.
+
value
+
Map에 추가하거나 변경할 요소의 값.
+
+ +

반환 값

+ +

호출한 Map 객체.

+ +

예제

+ +

set() 사용하기

+ +
var myMap = new Map();
+
+// Add new elements to the map
+myMap.set('bar', 'foo');
+myMap.set(1, 'foobar');
+
+// Update an element in the map
+myMap.set('bar', 'baz');
+
+ +

set() 체이닝

+ +

set()이 같은 Map을 반환하므로 메서드를 여러 번 연속해서 호출할 수 있습니다.

+ +
// Add new elements to the map with chaining.
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+
+ +

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
+ +

브라우저 호환성

+ + + +

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

+ +

같이 보기

+ + diff --git a/files/ko/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/ko/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..acbb861542 --- /dev/null +++ b/files/ko/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,63 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

size 접근자 프로퍼티는  {{jsxref("Map")}} 객체의 요소 갯수를 반환합니다.

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

설명

+ +

size 값은 얼마나 많은 엔트리를 Map 객체가 가지고 있는지를 표현합니다. size 를 설정할 수 있는 접근자 함수는 undefined 입니다. 당신은 이 프로퍼티를 변경할 수 없습니다.

+ +

예제

+ +

Using size

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

명세

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}}
+ +

브라우저 호환성

+ + + +

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

+ +

더 보기

+ + diff --git a/files/ko/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/ko/web/javascript/reference/global_objects/map/@@tostringtag/index.html deleted file mode 100644 index 7a1cd5002b..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: 'Map.prototype[@@toStringTag]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag ---- -
{{JSRef}}
- -

Map[@@toStringTag] 프로퍼티의 초기값은 "Map"입니다.

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

문법

- -
Map[Symbol.toStringTag]
- -

예제

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

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

diff --git a/files/ko/web/javascript/reference/global_objects/map/clear/index.html b/files/ko/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index fc63ff96d6..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

clear() 메서드는 Map 객체의 모든 요소를 제거합니다.

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

구문

- -
myMap.clear();
-
- -

예제

- -

clear() 사용하기

- -
var myMap = new Map();
-myMap.set('bar', 'baz');
-myMap.set(1, 'foo');
-
-myMap.size;       // 2
-myMap.has('bar'); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has('bar')  // false
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/delete/index.html b/files/ko/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 41110a28a9..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

delete() 메서드는 Map 객체에서 특정 요소를 제거합니다.

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

구문

- -
myMap.delete(key);
- -

매개변수

- -
-
key
-
Map 객체에서 제거할 요소의 키.
-
- -

반환 값

- -

요소가 Map 객체에 존재해서 제거했을 경우 true, 존재하지 않았으면 false.

- -

예제

- -

delete() 사용하기

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.delete('bar'); // Returns true. Successfully removed.
-myMap.has('bar');    // Returns false. The "bar" element is no longer present.
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/entries/index.html b/files/ko/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index 54242f373b..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

entries() 메서드는 Map 객체의 각 요소에 해당하는 [키, 값] 쌍을 Map에 등록한 순서대로 포함한 새로운 Iterator 객체를 반환합니다.

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

구문

- -
myMap.entries()
- -

반환 값

- -

A new {{jsxref("Map")}} iterator object.

- -

예제

- -

entries() 사용하기

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/foreach/index.html b/files/ko/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index 48b96eb570..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

forEach() 메소드는 Map 오브젝트 내의 key/value 쌍의 개수 만큼 주어진 함수를 순서대로 실행합니다. 

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

문법

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

파라미터

- -
-
callback
-
각각의 요소를 처리하기 위한 함수.
-
thisArg
-
 callback 을 실행할때 this 로 사용되는 값.
-
- -

Return value

- -

{{jsxref("undefined")}}.

- -

설명

- -

forEach 메서드는 map의 각각의 키마다 주어진 callback 함수를 실행합니다. 삭제된 키에대해서는 호출되지 않습니다. 그러나, 값이 존재하지만 undefined 인 값에 대해서는 실행됩니다.

- -

callback 은 3가지 인수로 호출됩니다.

- - - -

thisArg 파라미터가 forEach 에 제공되면, this 값으로 사용하기 위해 호출될때 callback 으로 넘겨집니다. 그렇지 않으면 undefined 값이 this 값으로 넘겨질 것입니다. 궁극적으로 callback 으로 보여지게 된 this 값은 함수에 의해 보여지는 this 를 결정하기 위한 일반적인 규칙에 따라 결정됩니다.

- -

각각의 value는 한번씩 사용됩니다. 다만 forEach 가 끝나기 전에 value가 삭제되거나 재추가 된 경우는 예외입니다. callback 은 사용되기 전에 삭제된 value에 의해 호출되지 않습니다. forEach 가 끝나기 전에 새롭게 추가된 value가 사용 됩니다.

- -

forEach 는 Map 오브젝트 내에 있는 각각의 요소마다 callback 함수를 실행합니다; 깂을 반환하지 않습니다.

- -

예제

- -

Map 오브젝트의 내용을 출력

- -

아래의 코드는 Map 오브젝트 내의 각각 요소들을 행별로 출력합니다:

- -
function logMapElements(value, key, map) {
-    console.log(`map.get('${key}') = ${value}`);
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
-// logs:
-// "map.get('foo') = 3"
-// "map.get('bar') = [object Object]"
-// "map.get('baz') = undefined"
-
- -

Specifications

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
- -

Browser compatibility

- - - -

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

- -

See also

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/get/index.html b/files/ko/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 835c8c3e6e..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

get() 메서드는 Map 객체에서 지정한 요소를 회수합니다.

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

구문

- -
myMap.get(key);
- -

매개변수

- -
-
key
-
Map 객체에서 회수할 요소의 키.
-
- -

반환 값

- -

주어진 키와 연결된 요소. 그런 요소가 없으면 {{jsxref("undefined")}}.

- -

예제

- -

get 사용하기

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');  // "foo" 반환.
-myMap.get('baz');  // undefined 반환.
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/has/index.html b/files/ko/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 60c5c03dfb..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

has() 메서드는 주어진 키를 가진 요소가 Map에 존재하는지를 반환합니다.

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

구문

- -
myMap.has(key);
- -

매개변수

- -
-
key
-
존재 여부를 판별할 키값.
-
- -

반환 값

- -

주어진 키를 가진 요소가 있으면 true, 아니면 false.

- -

예제

- -

has() 사용하기

- -
var myMap = new Map();
-myMap.set('bar', "foo");
-
-myMap.has('bar');  // returns true
-myMap.has('baz');  // returns false
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/index.html b/files/ko/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index f8b29bdf6e..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,244 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -

Map 객체는 키-값 쌍을 저장하며 각 쌍의 삽입 순서도 기억하는 콜렉션입니다. 아무 값(객체와 {{Glossary("Primitive", "원시 값")}})이라도 키와 값으로 사용할 수 있습니다.

- -

설명

- -

Map 객체는 요소의 삽입 순서대로 원소를 순회합니다. {{jsxref("Statements/for...of", "for...of")}} 반복문은 각 순회에서 [key, value]로 이루어진 배열을 반환합니다.

- -

키 동일성

- - - -

{{jsxref("Object")}}와 Map 비교

- -

{{jsxref("Object")}}는 값에 키를 할당할 수 있고, 그 키로 값을 얻을 수 있고, 키를 삭제할 수 있으며 어떤 키에 값이 존재하는지 확인할 수 있다는 점에서 Map과 유사합니다. 이런 이유에 더해, 이전에는 내장된 대체제가 없었기 때문에, Object를 Map 대신 사용하곤 했습니다.

- -

그러나 어떤 상황에선, Map을 선호해야 할 몇 가지 중요한 차이점이 있습니다.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MapObject
의도치 않은 키Map은 명시적으로 제공한 키 외에는 어떤 키도 가지지 않습니다. -

Object는 프로토타입을 가지므로 기본 키가 존재할 수 있습니다. 주의하지 않으면 직접 제공한 키와 충돌할 수도 있습니다.

- -
-

참고: ES5부터, 프로토타입으로 인한 키 충돌은 {{jsxref("Object.create", "Object.create(null)")}}로 해결할 수 있지만, 실제로 쓰이는 경우는 적습니다.

-
-
키 자료형Map의 키는 함수, 객체 등을 포함한 모든 값이 가능합니다.Object의 키는 반드시 {{jsxref("String")}} 또는 {{jsxref("Symbol")}}이어야 합니다.
키 순서 -

Map의 키는 정렬됩니다. 따라서 Map의 순회는 삽입순으로 이뤄집니다.

- 		-

Object의 키는 정렬되지 않습니다.

- -
-

참고: ECMAScript 201 이후로, 객체도 문자열과 Symbol 키의 생성 순서를 유지합니다. ECMEScript 2015 명세를 준수하는 JavaScript 엔진에서 문자열 키만 가진 객체를 순회하면 삽입 순을 따라갑니다.

-
-
크기Map의 항목 수는 {{jsxref("Map.prototype.size", "size")}} 속성을 통해 쉽게 알아낼 수 있습니다.Object의 항목 수는 직접 알아내야 합니다.
순회Map은 순회 가능하므로, 바로 순회할 수 있습니다.Object를 순회하려면 먼저 모든 키를 알아낸 후, 그 키의 배열을 순회해야 합니다.
성능잦은 키-값 쌍의 추가와 제거에서 더 좋은 성능을 보입니다.잦은 키-값 쌍의 추가와 제거를 위한 최적화가 없습니다.
- -

생성자

- -
-
{{jsxref("Map.Map", "Map()")}}
-
새로운 Map 객체를 생성합니다.
-
- -

속성

- -
-
Map.length
-
값이 0인 속성입니다.
- 요소의 수는 {{jsxref("Map.prototype.size")}}로 알아낼 수 있습니다.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
파생 객체를 생성하는데 사용하는 생성자 함수입니다.
-
{{jsxref("Map.prototype")}}
-
Map 생성자의 프로토타입을 나타냅니다. 모든 Map 인스턴스에 속성을 추가할 수 있습니다.
-
- -

Map 인스턴스

- -

모든 Map 인스턴스는 {{jsxref("Map.prototype")}}을 상속합니다.

- -

속성

- -

{{page('ko/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

- -

메서드

- -

{{page('ko/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

- -

예제

- -

Map 객체 사용하기

- -
let myMap = new Map()
-
-let keyString = '문자열'
-let keyObj    = {}
-let keyFunc   = function() {}
-
-// 값 설정
-myMap.set(keyString, "'문자열'과 관련된 값")
-myMap.set(keyObj, 'keyObj와 관련된 값')
-myMap.set(keyFunc, 'keyFunc와 관련된 값')
-
-myMap.size              // 3
-
-// getting the values
-myMap.get(keyString)    // "'문자열'과 관련된 값"
-myMap.get(keyObj)       // "keyObj와 관련된 값"
-myMap.get(keyFunc)      // "keyFunc와 관련된 값"
-
-myMap.get('문자열')    // "'문자열'과 관련된 값"
-                         // keyString === '문자열'이기 때문
-myMap.get({})            // undefined, keyObj !== {}
-myMap.get(function() {}) // undefined, keyFunc !== function () {}
- -

Map의 키로 NaN 사용하기

- -

{{jsxref("NaN")}}도 키로서 사용할 수 있습니다. 모든 NaN은 자기 자신과 동일하지 않지만(NaN !== NaN), NaN을 서로 구분할 수도 없기 때문에 아래 예제도 잘 동작합니다.

- -
let myMap = new Map()
-myMap.set(NaN, 'not a number')
-
-myMap.get(NaN)
-// "not a number"
-
-let otherNaN = Number('foo')
-myMap.get(otherNaN)
-// "not a number"
- -

for..of로 Map 순회하기

- -

Map은 for..of 반복문을 사용해 순회할 수 있습니다.

- -
let myMap = new Map()
-myMap.set(0, 'zero')
-myMap.set(1, 'one')
-
-for (let [key, value] of myMap) {
-  console.log(key + ' = ' + value)
-}
-// 0 = zero
-// 1 = one
-
-for (let key of myMap.keys()) {
-  console.log(key)
-}
-// 0
-// 1
-
-for (let value of myMap.values()) {
-  console.log(value)
-}
-// zero
-// one
-
-for (let [key, value] of myMap.entries()) {
-  console.log(key + ' = ' + value)
-}
-// 0 = zero
-// 1 = one
- -

forEach()로 Map 순회하기

- -

Map은 {{jsxref("Map.prototype.forEach", "forEach()")}} 메서드로 순회할 수 있습니다.

- -
myMap.forEach(function(value, key) {
-  console.log(key + ' = ' + value)
-})
-// 0 = zero
-// 1 = one
- -

Array 객체와의 관계

- -
let kvArray = [['key1', 'value1'], ['key2', 'value2']]
-
-// Use the regular Map constructor to transform a 2D key-value Array into a map
-let myMap = new Map(kvArray)
-
-myMap.get('key1') // returns "value1"
-
-// Use Array.from() to transform a map into a 2D key-value Array
-console.log(Array.from(myMap)) // Will show you exactly the same Array as kvArray
-
-// A succinct way to do the same, using the spread syntax
-console.log([...myMap])
-
-// Or use the keys() or values() iterators, and convert them to an array
-console.log(Array.from(myMap.keys())) // ["key1", "key2"]
- -

명세

- - - - - - - - - - -
Specification
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
- -

브라우저 호환성

- -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/map/index.html b/files/ko/web/javascript/reference/global_objects/map/map/index.html deleted file mode 100644 index 012772eec5..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/map/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Map() 생성자 -slug: Web/JavaScript/Reference/Global_Objects/Map/Map -tags: - - Constructor - - JavaScript - - Map - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map ---- -
{{JSRef}}
- -

Map() 생성자는 {{jsxref("Map")}} 객체를 생성합니다.

- -

구문

- -
new Map([iterable])
- -

매개변수

- -
-
iterable
-
요소가 키-값 쌍인, {{jsxref("Array")}} 또는 다른 순회 가능한 객체(예: [[1, 'one'], [2, 'two']]). 각 키-값 쌍은 새로운 Map에 포함됩니다.
-
- -

예제

- -
let myMap = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-])
-
- -

명세

- - - - - - - - - - -
Specification
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/set/index.html b/files/ko/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index a6c5afb140..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

set() 메서드는 Map 객체에서 주어진 키를 가진 요소를 추가하고, 키의 요소가 이미 있다면 대체합니다.

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

구문

- -
myMap.set(key, value);
- -

매개변수

- -
-
key
-
Map에 추가하거나 변경할 요소의 키.
-
value
-
Map에 추가하거나 변경할 요소의 값.
-
- -

반환 값

- -

호출한 Map 객체.

- -

예제

- -

set() 사용하기

- -
var myMap = new Map();
-
-// Add new elements to the map
-myMap.set('bar', 'foo');
-myMap.set(1, 'foobar');
-
-// Update an element in the map
-myMap.set('bar', 'baz');
-
- -

set() 체이닝

- -

set()이 같은 Map을 반환하므로 메서드를 여러 번 연속해서 호출할 수 있습니다.

- -
// Add new elements to the map with chaining.
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
-
- -

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

브라우저 호환성

- - - -

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

- -

같이 보기

- - diff --git a/files/ko/web/javascript/reference/global_objects/map/size/index.html b/files/ko/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 371d8b3110..0000000000 --- a/files/ko/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

size 접근자 프로퍼티는  {{jsxref("Map")}} 객체의 요소 갯수를 반환합니다.

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

설명

- -

size 값은 얼마나 많은 엔트리를 Map 객체가 가지고 있는지를 표현합니다. size 를 설정할 수 있는 접근자 함수는 undefined 입니다. 당신은 이 프로퍼티를 변경할 수 없습니다.

- -

예제

- -

Using size

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

명세

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}}
- -

브라우저 호환성

- - - -

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

- -

더 보기

- - diff --git a/files/pl/_redirects.txt b/files/pl/_redirects.txt index 90055f2d98..410af36650 100644 --- a/files/pl/_redirects.txt +++ b/files/pl/_redirects.txt @@ -2505,6 +2505,17 @@ /pl/docs/Web/JavaScript/Reference/Errors/Brakujący_średnik_po_własności_id /pl/docs/Web/JavaScript/Reference/Errors/Missing_colon_after_property_id /pl/docs/Web/JavaScript/Reference/Functions/Funkcje_strzalkowe /pl/docs/Web/JavaScript/Reference/Functions/Arrow_functions /pl/docs/Web/JavaScript/Reference/Functions/Parametry_domyślne /pl/docs/Web/JavaScript/Reference/Functions/Default_parameters +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/get /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/has /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/set /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/size /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/pl/docs/Web/JavaScript/Reference/Global_Objects/Map/values /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /pl/docs/Web/JavaScript/Reference/Operators/Pipeline_operator /pl/docs/orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator /pl/docs/Web/JavaScript/Referencje /pl/docs/Web/JavaScript/Reference /pl/docs/Web/JavaScript/Referencje/Funkcje /pl/docs/Web/JavaScript/Reference/Global_Objects @@ -2656,17 +2667,17 @@ /pl/docs/Web/JavaScript/Referencje/Obiekty/Generator /pl/docs/Web/JavaScript/Reference/Global_Objects/Generator /pl/docs/Web/JavaScript/Referencje/Obiekty/Infinity /pl/docs/Web/JavaScript/Reference/Global_Objects/Infinity /pl/docs/Web/JavaScript/Referencje/Obiekty/JSON /pl/docs/Web/JavaScript/Reference/Global_Objects/JSON -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map /pl/docs/Web/JavaScript/Reference/Global_Objects/Map -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/clear /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/clear -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/delete /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/delete -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/entries /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/entries -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/forEach /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/get /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/get -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/has /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/has -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/keys /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/keys -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/set /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/set -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/size /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/size -/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/values /pl/docs/Web/JavaScript/Reference/Global_Objects/Map/values +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/clear /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/delete /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/entries /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/forEach /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/get /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/has /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/keys /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/set /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/size /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/pl/docs/Web/JavaScript/Referencje/Obiekty/Map/values /pl/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /pl/docs/Web/JavaScript/Referencje/Obiekty/Math /pl/docs/Web/JavaScript/Reference/Global_Objects/Math /pl/docs/Web/JavaScript/Referencje/Obiekty/Math/E /pl/docs/Web/JavaScript/Reference/Global_Objects/Math/E /pl/docs/Web/JavaScript/Referencje/Obiekty/Math/LN10 /pl/docs/Web/JavaScript/Reference/Global_Objects/Math/LN10 diff --git a/files/pl/_wikihistory.json b/files/pl/_wikihistory.json index ba15500870..727016ba32 100644 --- a/files/pl/_wikihistory.json +++ b/files/pl/_wikihistory.json @@ -7867,77 +7867,6 @@ "krupinskij" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-09-01T10:21:27.914Z", - "contributors": [ - "struginskij", - "KonradLinkowski", - "108adams", - "Asek90", - "xgarrett", - "broslukasz" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-10-15T22:01:01.515Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T22:01:01.152Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2019-03-18T21:42:37.088Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T22:01:04.417Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T22:01:06.016Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T22:01:05.981Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2020-10-15T22:01:06.126Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-15T22:01:06.173Z", - "contributors": [ - "MarekHuckmann" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-10-15T22:17:26.741Z", - "contributors": [ - "tipakA" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-10-15T22:01:06.933Z", - "contributors": [ - "MarekHuckmann" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2019-11-16T16:52:10.805Z", "contributors": [ @@ -11666,6 +11595,77 @@ "Ptak82" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-09-01T10:21:27.914Z", + "contributors": [ + "struginskij", + "KonradLinkowski", + "108adams", + "Asek90", + "xgarrett", + "broslukasz" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-10-15T22:01:01.515Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T22:01:01.152Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2019-03-18T21:42:37.088Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T22:01:04.417Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T22:01:06.016Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T22:01:05.981Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2020-10-15T22:01:06.126Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-15T22:01:06.173Z", + "contributors": [ + "MarekHuckmann" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-10-15T22:17:26.741Z", + "contributors": [ + "tipakA" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-10-15T22:01:06.933Z", + "contributors": [ + "MarekHuckmann" + ] + }, "orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator": { "modified": "2020-10-15T22:08:04.976Z", "contributors": [ diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..cbe8eaab2d --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,88 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

Metoda clear() usuwa wszystkie elementy z obiektu Map.

+ +
var map1 = new Map();
+
+map1.set('bar', 'baz');
+map1.set(1, 'foo');
+
+console.log(map1.size);
+// wartość zwracana: 2
+
+map1.clear();
+
+console.log(map1.size);
+// wartość zwracana: 0
+
+ +

Składnia

+ +
myMap.clear();
+ +

Zwracana wartość

+ +

{{jsxref("undefined")}}.

+ +

Przykłady

+ +

Używanie metody clear

+ +
var myMap = new Map();
+myMap.set('bar', 'baz');
+myMap.set(1, 'foo');
+
+myMap.size;       // 2
+myMap.has('bar'); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has('bar')  // false
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..975d5326b7 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,86 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - Mapa + - Metodă +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

Metoda delete() usuwa określony element z obiektu Map.

+ +
var map1 = new Map();
+map1.set('bar', 'foo');
+
+console.log(map1.delete('bar'));
+// oczekiwany wynik: true
+// (true wskazuje na poprawne usunięcie)
+
+console.log(map1.has('bar'));
+// oczekiwany wynik: false
+
+ +

Składnia

+ +
myMap.delete(key);
+ +

Parametery

+ +
+
key
+
Wymagany. Klucz elementu, który ma zostać usunięty z obiektu Map.
+
+ +

Zwracana wartość

+ +
+
Boolean
+
Zwraca true, jeśli element w Map istniał i został usunięty lub false, jeśli nie.
+
+ +

Przykłady

+ +

Używanie metody delete

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.delete('bar'); // Zwraca true. Udało się usunąć.
+myMap.has('bar');    // Zwraca false. Element "bar" już nie istnieje.
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..8e9de87679 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,129 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript2015 + - Iterator + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

Metoda entries() zwraca nowy obiekt typu Iterator który zawiera pary[klucz, wartość] dla każdego elementu Mapy. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

+ +
myMap.entries()
+ +

Zwracana wartość

+ +

Nowy iterator obiektu typu {{jsxref("Map")}}.

+ +

Przykłady

+ +

Używanie entries()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Początkowa definicja.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatVersionUnknown}}{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatVersionUnknown}}{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..6ba031adbc --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,105 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript2015 + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

Metoda forEach() wykonuje dostarczoną funcję callback raz dla każdej pary klucz-wartosć Mapy w kolejności, w jakiej zostały zostały wstawione.

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

Składnia

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

Parametry

+ +
+
callback
+
Funkcja wykonywana dla każdego elementu.
+
thisArg
+
Wartość przypisywana do this poczas wywołania zwrotnego (funkcja callback).
+
+ +

Zwracana wartosć

+ +

{{jsxref("undefined")}}.

+ +

Opis

+ +

Metoda forEach wykonuje dostarczoną funkcję callback raz dla każdego klucza mapy, który istnieje. Nie jest wywoływana dla usuniętych kluczy, ale dla istniejących z wartością undefined już tak.

+ +

Funkcja callback przyjmuje trzy argumenty:

+ + + +

Jeśli argument thisArg jest dostarczony do forEach, zostaje przekazany do fukncji callback podczas jej wywołania, jako jej własna wartość this.  W przeciwnym wypadku, this przyjmuje wartość undefined. 

+ +

Każda wartość jest odwiedzana raz, oprócz przypadku, gdzie została usunięta, a następnie dodana ponownie, nim metoda forEach zakończyła swoje działanie. Funkcja callback nie jest wywoływana dla wartości usuniętych przed ich odwiedzeniem. Nowe wartości dodane jeszcze przed zakończeniem forEach zostaną odwiedzone.

+ +

Metoda forEach nie zwraca żadnej wartości.

+ +

Przykłady

+ +

Wyświetlanie zawartości Mapy

+ +

Poniższy kod wyświetla jedną linię dla każdej pary klucz-wartość Mapy:

+ +
function logMapElements(value, key, map) {
+    console.log(`m[${key}] = ${value}`);
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
+// logs:
+// "m[foo] = 3"
+// "m[bar] = [object Object]"
+// "m[baz] = undefined"
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

See also

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..afdb516877 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,81 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

Metoda get() zwraca podany element Mapy.

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

Składnia

+ +
myMap.get(key);
+ +

Parametry

+ +
+
key
+
Wymagany. Klucz elementu, który ma zostać zwrócony.
+
+ +

Zwracana wartość

+ +

Element powiązany z danym kluczym lub undefined, jeśli klucz nie został odnaleziony.

+ +

Przykłady

+ +

Używanie metody get

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');  // zwraca "foo".
+myMap.get('baz');  // zwraca undefined.
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..c6d61e9855 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,86 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

Metoda has() zwraca Boolean, który określa czy element o podanym kluczu istnieje.

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

Składnia

+ +
myMap.has(key);
+ +

Parametry

+ +
+
key
+
Wymagany. Klucz elementu, którego istnienie w Mapie zostanie sprawdzone.
+
+ +

Zwracana wartość

+ +
+
Boolean
+
+

true, jeśli dany element istnieje w Mapie - w przeciwnym wypadku false.

+
+
+ +

Przykłady

+ +

Używanie metody has

+ +
var myMap = new Map();
+myMap.set('bar', "foo");
+
+myMap.has('bar');  // zwraca true
+myMap.has('baz');  // zwraca false
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..90dad3e7d9 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,459 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +

Map jest prostym obiektem mapującym klucze na wartości. Każdy element (zarówno obiekt jak i {{Glossary("Primitive", "wartości proste")}}) mogą być użyte zarówno jako klucz jak i wartość.

+ +

Składnia

+ +
new Map([iterable])
+ +

Parametry

+ +
+
iterable
+
Iterable jest tablicą lub innym iterowalnym obiektem, którego elementy są parami typu klucz-wartość (np. 2 elementowa tablica). Każda para klucz-wartość jest dodawana do obiektu new Map. null jest traktowane jako undefined.
+
+ +

Opis

+ +

Obiekt Map iteruje swoje elementy we wprowadzonej kolejności — pętla {{jsxref("Statements/for...of", "for...of")}} zwraca tablicę  [key, value] dla każdej iteracji.

+ +

Należy pamiętać, że kolejność iteracji dla Map mapującej obiekty, w szczególności np. dla słownika słowników, odzwieciedlać będzie jedynie kolejność dodawania obiektów do kolekcji, natomiast kolejność dodawania elementów do samych obiektów nie jest gwarantowana i powinna być traktowana jako losowa.

+ +

Równość kluczy

+ +

Klucze porównywane są według algorytmu "same-value" (tej samej wartości).

+ +

NaN jest traktowana jako równa NaN (mimo tego, że NaN !== NaN). Wszystkie inne wartości są uważane za równe zgodnie z semantyką ===  operatora równości.

+ +

W obecnej specyfikacji ECMAScript -0 === +0, choć wcześniejsze propozycje zakładały inne zachowanie, co zaowocowało implementacją w niektórych wersjach przeglądarek. Szczegóły zawarte są w  "Value equality for -0 and 0"  w tabeli kompatybilności przeglądarek.

+ +

Porównanie Obiektów i Map

+ +

{{jsxref("Object", "Obiekty")}} są podobne do Map. W obu przypadkach pozwalają ustawić klucze dla wartości, zwracają te wartości, usuwają klucze i wykrywają czy coś jest przechowywane jako klucz. Z tego powodu (i ponieważ nie było innych wbudowanych alternatyw), Object  był używany wcześniej jako Map. Istnieją jednak ważne różnice pomiędzy Obiektami i Mapami, które powodują, że Map jest lepszym wyborem w pewnych przypadkach:

+ + + +

Nie oznacza to, że powinno się używać Maps wszędzie. Obiekty są wciąż używane w większości przypadków.  Instancje Map są użyteczne dla kolekcji, warto rozważyć ich zaadaptowanie jedynie w przypadkach, gdy wcześniej używano dla nich obiektów. Obiekty powinny być używane jako rejestr z polami i metodami. Jeśli wciąż nie jesteś pewien czego użyć, pomocne mogą okazać się poniższe pytania:

+ + + +

Jeśli odpowiedziałeś 'tak' na którekolwiek z tych pytań, prawdopodobnie powinieneś użyć Map. I przeciwnie, jeśli masz zamknięty zbiór kluczy, jeśli musisz odwoływać się do poszczególnych, specyficznych kluczy a każdy z nich ma swoje, odrębne od innych znaczenie, najprawdopodobniej potrzebujesz obiektu.

+ +

Własności

+ +
+
Map.length
+
Wartość length  jest zawsze równa 0.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
Funkcja konstruktora używana do tworzenia obiektów pochodnych.
+
{{jsxref("Map.prototype")}}
+
Reprezentuje prototyp funkcji konstruktora Map. Pozwala rozszerzać prototyp wszystkich obiektów Map o własne własności.
+
+ +

Instancje Map

+ +

Wszystkie instancje Map  dziedziczą po {{jsxref("Map.prototype")}}.

+ +

Własności

+ +

{{page('en-US/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

+ +

Metody

+ +

{{page('en-US/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

+ +

Przykłady

+ +

Używanie obiektu typu Map

+ +
var myMap = new Map();
+
+var keyString = 'a string',
+    keyObj = {},
+    keyFunc = function() {};
+
+// setting the values
+myMap.set(keyString, "value associated with 'a string'");
+myMap.set(keyObj, 'value associated with keyObj');
+myMap.set(keyFunc, 'value associated with keyFunc');
+
+myMap.size; // 3
+
+// getting the values
+myMap.get(keyString);    // "value associated with 'a string'"
+myMap.get(keyObj);       // "value associated with keyObj"
+myMap.get(keyFunc);      // "value associated with keyFunc"
+
+myMap.get('a string');   // "value associated with 'a string'"
+                         // because keyString === 'a string'
+myMap.get({});           // undefined, because keyObj !== {}
+myMap.get(function() {}) // undefined, because keyFunc !== function () {}
+
+ +

Użycie NaN jako kluczy w  Map

+ +

NaN can also be used as a key. Even though every NaN is not equal to itself (NaN !== NaN is true), the following example works, because NaNs are indistinguishable from each other:

+ +
var myMap = new Map();
+myMap.set(NaN, 'not a number');
+
+myMap.get(NaN); // "not a number"
+
+var otherNaN = Number('foo');
+myMap.get(otherNaN); // "not a number"
+
+ +

Iteracja po Map przy użyciu for..of

+ +
var myMap = new Map();
+myMap.set(0, 'zero');
+myMap.set(1, 'one');
+for (var [key, value] of myMap) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+for (var key of myMap.keys()) {
+  console.log(key);
+}
+// 0
+// 1
+
+for (var value of myMap.values()) {
+  console.log(value);
+}
+// zero
+// one
+
+for (var [key, value] of myMap.entries()) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+ +

Iteracja po Map przy użyciu forEach()

+ +
myMap.forEach(function(value, key) {
+  console.log(key + ' = ' + value);
+});
+// Will show 2 logs; first with "0 = zero" and second with "1 = one"
+
+ +

Relacja do obiektów typu Array

+ +
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
+
+// Use the regular Map constructor to transform a 2D key-value Array into a map
+var myMap = new Map(kvArray);
+
+myMap.get('key1'); // returns "value1"
+
+// Use the spread operator to transform a map into a 2D key-value Array.
+console.log(uneval([...myMap])); // Will show you exactly the same Array as kvArray
+
+// Or use the spread operator on the keys or values iterator to get
+// an array of only the keys or values
+console.log(uneval([...myMap.keys()])); // Will show ["key1", "key2"]
+
+ +

Specyfikacje

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Początkowa definicja
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
+ +

Kompatybilność przeglądarek

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support +

{{ CompatChrome(38) }} [1]

+ 		12{{ CompatGeckoDesktop("13") }}11257.1
Constructor argument: new Map(iterable){{ CompatChrome(38) }}12{{ CompatGeckoDesktop("13") }}{{CompatNo}}25{{CompatSafari("9")}}
iterable{{ CompatChrome(38) }}12{{ CompatGeckoDesktop("17") }}{{CompatNo}}257.1
Map.clear(){{ CompatChrome(31) }}
+ {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("19")}}11257.1
Map.keys(), Map.values(), Map.entries(){{ CompatChrome(37) }}
+ {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
Map.forEach(){{ CompatChrome(36) }}
+ {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("25")}}11257.1
Key equality for -0 and 0{{ CompatChrome(34) }}
+ {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("29")}}{{CompatNo}}25{{CompatSafari("9")}}
Constructor argument: new Map(null){{CompatVersionUnknown}}12{{CompatGeckoDesktop("37")}}11{{CompatVersionUnknown}}{{CompatSafari("9")}}
Monkey-patched set() in Constructor{{CompatVersionUnknown}}12{{CompatGeckoDesktop("37")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatSafari("9")}}
Map[@@species]{{CompatChrome("51")}}13{{CompatGeckoDesktop("41")}}{{CompatNo}}{{CompatOpera("38")}}{{CompatSafari("10")}}
Map() without new throws{{CompatVersionUnknown}}12{{ CompatGeckoDesktop("42") }}11{{CompatVersionUnknown}}{{CompatSafari("9")}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{ CompatChrome(38) }} [1]{{ CompatGeckoMobile("13") }}{{CompatNo}}{{CompatNo}}8
Constructor argument: new Map(iterable){{CompatNo}}{{ CompatChrome(38) }}{{ CompatGeckoMobile("13") }}{{CompatNo}}{{CompatNo}}9
iterable{{CompatNo}}{{CompatNo}}{{ CompatGeckoMobile("17") }}{{CompatNo}}{{CompatNo}}8
Map.clear(){{CompatNo}}{{ CompatChrome(31) }}
+ {{ CompatChrome(38) }}		{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
Map.keys(), Map.values(), Map.entries(){{CompatNo}}{{ CompatChrome(37) }}
+ {{ CompatChrome(38) }}		{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
Map.forEach(){{CompatNo}}{{ CompatChrome(36) }}
+ {{ CompatChrome(38) }}		{{CompatGeckoMobile("25")}}{{CompatNo}}{{CompatNo}}8
Key equality for -0 and 0{{CompatNo}}{{ CompatChrome(34) }}
+ {{ CompatChrome(38) }}		{{CompatGeckoMobile("29")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Constructor argument: new Map(null){{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("37")}}{{CompatUnknown}}{{CompatUnknown}}9
Monkey-patched set() in Constructor{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("37")}}{{CompatUnknown}}{{CompatUnknown}}9
Map[@@species]{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("41")}}{{CompatUnknown}}{{CompatUnknown}}10
Map() without new throws5.1{{CompatUnknown}}{{CompatGeckoMobile("42")}}{{CompatUnknown}}{{CompatUnknown}}9
+
+ +

[1] Starting with Chrome 31, the feature was available behind a preference. In chrome://flags, activate the entry “Enable Experimental JavaScript”.

+ +

Zobacz też

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..2d172c5bf5 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,79 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

Metoda keys() zwraca nowy obiekt typu Iterator, który zawiera klucze dla każdego elementu w Mapie. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

+ +
myMap.keys()
+ +

Zwracana wartość

+ +

Nowy iterator obiektu typu {{jsxref("Map")}}

+ +

Przykłady

+ +

Używanie keys()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..af414240a0 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,97 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

Metoda set() dodaje lub zmienia element o podany kluczu i wartości w Mapie. 

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

Składnia

+ +
myMap.set(key, value);
+ +

Parametry

+ +
+
key
+
Wymagany. Klucz elementu, który zostanie dodany do Mapy.
+
value
+
Wymagany. Wartość elementu, który zostanie dodany do Mapy.
+
+ +

Zwracana wartość

+ +

 Obiekt typu Map.

+ +

Przykłady

+ +

Używanie set()

+ +
var myMap = new Map();
+
+// Dodawanie nowych elementu
+myMap.set('bar', 'foo');
+myMap.set(1, 'foobar');
+
+// Zmiana istniejącego już elementu
+myMap.set('bar', 'baz');
+
+ +

Używanie set w połączeniu z łańcuchowaniem

+ +

Ponieważ set() zwraca ten sam obiekt typu Mapa, można użyć chainingu (uruchamianie metod jedna po drugiej na danym obiekcie przy użyciu kropek).

+ +
// Dodawanie elementów do mapy za pomocą chainingu
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+
+
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Definicja początowa.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..2afa720805 --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,66 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +tags: + - JavaScript + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

Atrybut size zwraca ilość elementów znajdujących się w obiekcie {{jsxref("Map")}}.

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

Opis

+ +

Wartość size to liczba reprezentująca ile elementów posiada obiekt Map. Funkcja set dla size to undefined; nie można edytować tego atrybutu.

+ +

Przykłady

+ +

Użycie size

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

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność

+ + + +

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

+ +

Zobacz także

+ + diff --git a/files/pl/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/pl/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..62e2b767bd --- /dev/null +++ b/files/pl/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Mapa + - Metodă + - Prototyp +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

Metoda values() zwraca nowy obiekt typu Iterator, który zawiera wartości dla każdego elementu w Mapie. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

+ +
myMap.values()
+ +

Zwracana wartość

+ +

Nowy iterator obiektu typu {{jsxref("Map")}}.

+ +

Przykłady

+ +

Używanie values()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

Specyfikacja

+ + + + + + + + + + + + + + + + + + + +
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

Kompatybilność z przeglądarkami

+ + + +

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

+ +

Zobacz również

+ + diff --git a/files/pl/web/javascript/reference/global_objects/map/clear/index.html b/files/pl/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 15fa630779..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear -original_slug: Web/JavaScript/Referencje/Obiekty/Map/clear ---- -
{{JSRef}}
- -

Metoda clear() usuwa wszystkie elementy z obiektu Map.

- -
var map1 = new Map();
-
-map1.set('bar', 'baz');
-map1.set(1, 'foo');
-
-console.log(map1.size);
-// wartość zwracana: 2
-
-map1.clear();
-
-console.log(map1.size);
-// wartość zwracana: 0
-
- -

Składnia

- -
myMap.clear();
- -

Zwracana wartość

- -

{{jsxref("undefined")}}.

- -

Przykłady

- -

Używanie metody clear

- -
var myMap = new Map();
-myMap.set('bar', 'baz');
-myMap.set(1, 'foo');
-
-myMap.size;       // 2
-myMap.has('bar'); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has('bar')  // false
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/delete/index.html b/files/pl/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index bb33f16d44..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - Mapa - - Metodă -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete -original_slug: Web/JavaScript/Referencje/Obiekty/Map/delete ---- -
{{JSRef}}
- -

Metoda delete() usuwa określony element z obiektu Map.

- -
var map1 = new Map();
-map1.set('bar', 'foo');
-
-console.log(map1.delete('bar'));
-// oczekiwany wynik: true
-// (true wskazuje na poprawne usunięcie)
-
-console.log(map1.has('bar'));
-// oczekiwany wynik: false
-
- -

Składnia

- -
myMap.delete(key);
- -

Parametery

- -
-
key
-
Wymagany. Klucz elementu, który ma zostać usunięty z obiektu Map.
-
- -

Zwracana wartość

- -
-
Boolean
-
Zwraca true, jeśli element w Map istniał i został usunięty lub false, jeśli nie.
-
- -

Przykłady

- -

Używanie metody delete

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.delete('bar'); // Zwraca true. Udało się usunąć.
-myMap.has('bar');    // Zwraca false. Element "bar" już nie istnieje.
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/entries/index.html b/files/pl/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index 25589210ac..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript2015 - - Iterator - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries -original_slug: Web/JavaScript/Referencje/Obiekty/Map/entries ---- -
{{JSRef}}
- -

Metoda entries() zwraca nowy obiekt typu Iterator który zawiera pary[klucz, wartość] dla każdego elementu Mapy. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

- -
myMap.entries()
- -

Zwracana wartość

- -

Nowy iterator obiektu typu {{jsxref("Map")}}.

- -

Przykłady

- -

Używanie entries()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Początkowa definicja.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatVersionUnknown}}{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatVersionUnknown}}{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
-
- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/foreach/index.html b/files/pl/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index ec53470515..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript2015 - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach -original_slug: Web/JavaScript/Referencje/Obiekty/Map/forEach ---- -
{{JSRef}}
- -

Metoda forEach() wykonuje dostarczoną funcję callback raz dla każdej pary klucz-wartosć Mapy w kolejności, w jakiej zostały zostały wstawione.

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

Składnia

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

Parametry

- -
-
callback
-
Funkcja wykonywana dla każdego elementu.
-
thisArg
-
Wartość przypisywana do this poczas wywołania zwrotnego (funkcja callback).
-
- -

Zwracana wartosć

- -

{{jsxref("undefined")}}.

- -

Opis

- -

Metoda forEach wykonuje dostarczoną funkcję callback raz dla każdego klucza mapy, który istnieje. Nie jest wywoływana dla usuniętych kluczy, ale dla istniejących z wartością undefined już tak.

- -

Funkcja callback przyjmuje trzy argumenty:

- - - -

Jeśli argument thisArg jest dostarczony do forEach, zostaje przekazany do fukncji callback podczas jej wywołania, jako jej własna wartość this.  W przeciwnym wypadku, this przyjmuje wartość undefined. 

- -

Każda wartość jest odwiedzana raz, oprócz przypadku, gdzie została usunięta, a następnie dodana ponownie, nim metoda forEach zakończyła swoje działanie. Funkcja callback nie jest wywoływana dla wartości usuniętych przed ich odwiedzeniem. Nowe wartości dodane jeszcze przed zakończeniem forEach zostaną odwiedzone.

- -

Metoda forEach nie zwraca żadnej wartości.

- -

Przykłady

- -

Wyświetlanie zawartości Mapy

- -

Poniższy kod wyświetla jedną linię dla każdej pary klucz-wartość Mapy:

- -
function logMapElements(value, key, map) {
-    console.log(`m[${key}] = ${value}`);
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
-// logs:
-// "m[foo] = 3"
-// "m[bar] = [object Object]"
-// "m[baz] = undefined"
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

See also

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/get/index.html b/files/pl/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index b9b3da5da3..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get -original_slug: Web/JavaScript/Referencje/Obiekty/Map/get ---- -
{{JSRef}}
- -

Metoda get() zwraca podany element Mapy.

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

Składnia

- -
myMap.get(key);
- -

Parametry

- -
-
key
-
Wymagany. Klucz elementu, który ma zostać zwrócony.
-
- -

Zwracana wartość

- -

Element powiązany z danym kluczym lub undefined, jeśli klucz nie został odnaleziony.

- -

Przykłady

- -

Używanie metody get

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');  // zwraca "foo".
-myMap.get('baz');  // zwraca undefined.
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/has/index.html b/files/pl/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 3f9f330b4e..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has -original_slug: Web/JavaScript/Referencje/Obiekty/Map/has ---- -
{{JSRef}}
- -

Metoda has() zwraca Boolean, który określa czy element o podanym kluczu istnieje.

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

Składnia

- -
myMap.has(key);
- -

Parametry

- -
-
key
-
Wymagany. Klucz elementu, którego istnienie w Mapie zostanie sprawdzone.
-
- -

Zwracana wartość

- -
-
Boolean
-
-

true, jeśli dany element istnieje w Mapie - w przeciwnym wypadku false.

-
-
- -

Przykłady

- -

Używanie metody has

- -
var myMap = new Map();
-myMap.set('bar', "foo");
-
-myMap.has('bar');  // zwraca true
-myMap.has('baz');  // zwraca false
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/index.html b/files/pl/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index a72cd3dc26..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,459 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map -original_slug: Web/JavaScript/Referencje/Obiekty/Map ---- -
{{JSRef}}
- -

Map jest prostym obiektem mapującym klucze na wartości. Każdy element (zarówno obiekt jak i {{Glossary("Primitive", "wartości proste")}}) mogą być użyte zarówno jako klucz jak i wartość.

- -

Składnia

- -
new Map([iterable])
- -

Parametry

- -
-
iterable
-
Iterable jest tablicą lub innym iterowalnym obiektem, którego elementy są parami typu klucz-wartość (np. 2 elementowa tablica). Każda para klucz-wartość jest dodawana do obiektu new Map. null jest traktowane jako undefined.
-
- -

Opis

- -

Obiekt Map iteruje swoje elementy we wprowadzonej kolejności — pętla {{jsxref("Statements/for...of", "for...of")}} zwraca tablicę  [key, value] dla każdej iteracji.

- -

Należy pamiętać, że kolejność iteracji dla Map mapującej obiekty, w szczególności np. dla słownika słowników, odzwieciedlać będzie jedynie kolejność dodawania obiektów do kolekcji, natomiast kolejność dodawania elementów do samych obiektów nie jest gwarantowana i powinna być traktowana jako losowa.

- -

Równość kluczy

- -

Klucze porównywane są według algorytmu "same-value" (tej samej wartości).

- -

NaN jest traktowana jako równa NaN (mimo tego, że NaN !== NaN). Wszystkie inne wartości są uważane za równe zgodnie z semantyką ===  operatora równości.

- -

W obecnej specyfikacji ECMAScript -0 === +0, choć wcześniejsze propozycje zakładały inne zachowanie, co zaowocowało implementacją w niektórych wersjach przeglądarek. Szczegóły zawarte są w  "Value equality for -0 and 0"  w tabeli kompatybilności przeglądarek.

- -

Porównanie Obiektów i Map

- -

{{jsxref("Object", "Obiekty")}} są podobne do Map. W obu przypadkach pozwalają ustawić klucze dla wartości, zwracają te wartości, usuwają klucze i wykrywają czy coś jest przechowywane jako klucz. Z tego powodu (i ponieważ nie było innych wbudowanych alternatyw), Object  był używany wcześniej jako Map. Istnieją jednak ważne różnice pomiędzy Obiektami i Mapami, które powodują, że Map jest lepszym wyborem w pewnych przypadkach:

- - - -

Nie oznacza to, że powinno się używać Maps wszędzie. Obiekty są wciąż używane w większości przypadków.  Instancje Map są użyteczne dla kolekcji, warto rozważyć ich zaadaptowanie jedynie w przypadkach, gdy wcześniej używano dla nich obiektów. Obiekty powinny być używane jako rejestr z polami i metodami. Jeśli wciąż nie jesteś pewien czego użyć, pomocne mogą okazać się poniższe pytania:

- - - -

Jeśli odpowiedziałeś 'tak' na którekolwiek z tych pytań, prawdopodobnie powinieneś użyć Map. I przeciwnie, jeśli masz zamknięty zbiór kluczy, jeśli musisz odwoływać się do poszczególnych, specyficznych kluczy a każdy z nich ma swoje, odrębne od innych znaczenie, najprawdopodobniej potrzebujesz obiektu.

- -

Własności

- -
-
Map.length
-
Wartość length  jest zawsze równa 0.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
Funkcja konstruktora używana do tworzenia obiektów pochodnych.
-
{{jsxref("Map.prototype")}}
-
Reprezentuje prototyp funkcji konstruktora Map. Pozwala rozszerzać prototyp wszystkich obiektów Map o własne własności.
-
- -

Instancje Map

- -

Wszystkie instancje Map  dziedziczą po {{jsxref("Map.prototype")}}.

- -

Własności

- -

{{page('en-US/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

- -

Metody

- -

{{page('en-US/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

- -

Przykłady

- -

Używanie obiektu typu Map

- -
var myMap = new Map();
-
-var keyString = 'a string',
-    keyObj = {},
-    keyFunc = function() {};
-
-// setting the values
-myMap.set(keyString, "value associated with 'a string'");
-myMap.set(keyObj, 'value associated with keyObj');
-myMap.set(keyFunc, 'value associated with keyFunc');
-
-myMap.size; // 3
-
-// getting the values
-myMap.get(keyString);    // "value associated with 'a string'"
-myMap.get(keyObj);       // "value associated with keyObj"
-myMap.get(keyFunc);      // "value associated with keyFunc"
-
-myMap.get('a string');   // "value associated with 'a string'"
-                         // because keyString === 'a string'
-myMap.get({});           // undefined, because keyObj !== {}
-myMap.get(function() {}) // undefined, because keyFunc !== function () {}
-
- -

Użycie NaN jako kluczy w  Map

- -

NaN can also be used as a key. Even though every NaN is not equal to itself (NaN !== NaN is true), the following example works, because NaNs are indistinguishable from each other:

- -
var myMap = new Map();
-myMap.set(NaN, 'not a number');
-
-myMap.get(NaN); // "not a number"
-
-var otherNaN = Number('foo');
-myMap.get(otherNaN); // "not a number"
-
- -

Iteracja po Map przy użyciu for..of

- -
var myMap = new Map();
-myMap.set(0, 'zero');
-myMap.set(1, 'one');
-for (var [key, value] of myMap) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
-for (var key of myMap.keys()) {
-  console.log(key);
-}
-// 0
-// 1
-
-for (var value of myMap.values()) {
-  console.log(value);
-}
-// zero
-// one
-
-for (var [key, value] of myMap.entries()) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
- -

Iteracja po Map przy użyciu forEach()

- -
myMap.forEach(function(value, key) {
-  console.log(key + ' = ' + value);
-});
-// Will show 2 logs; first with "0 = zero" and second with "1 = one"
-
- -

Relacja do obiektów typu Array

- -
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
-
-// Use the regular Map constructor to transform a 2D key-value Array into a map
-var myMap = new Map(kvArray);
-
-myMap.get('key1'); // returns "value1"
-
-// Use the spread operator to transform a map into a 2D key-value Array.
-console.log(uneval([...myMap])); // Will show you exactly the same Array as kvArray
-
-// Or use the spread operator on the keys or values iterator to get
-// an array of only the keys or values
-console.log(uneval([...myMap.keys()])); // Will show ["key1", "key2"]
-
- -

Specyfikacje

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Początkowa definicja
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

Kompatybilność przeglądarek

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support -

{{ CompatChrome(38) }} [1]

- 		12{{ CompatGeckoDesktop("13") }}11257.1
Constructor argument: new Map(iterable){{ CompatChrome(38) }}12{{ CompatGeckoDesktop("13") }}{{CompatNo}}25{{CompatSafari("9")}}
iterable{{ CompatChrome(38) }}12{{ CompatGeckoDesktop("17") }}{{CompatNo}}257.1
Map.clear(){{ CompatChrome(31) }}
- {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("19")}}11257.1
Map.keys(), Map.values(), Map.entries(){{ CompatChrome(37) }}
- {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
Map.forEach(){{ CompatChrome(36) }}
- {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("25")}}11257.1
Key equality for -0 and 0{{ CompatChrome(34) }}
- {{ CompatChrome(38) }}		12{{CompatGeckoDesktop("29")}}{{CompatNo}}25{{CompatSafari("9")}}
Constructor argument: new Map(null){{CompatVersionUnknown}}12{{CompatGeckoDesktop("37")}}11{{CompatVersionUnknown}}{{CompatSafari("9")}}
Monkey-patched set() in Constructor{{CompatVersionUnknown}}12{{CompatGeckoDesktop("37")}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatSafari("9")}}
Map[@@species]{{CompatChrome("51")}}13{{CompatGeckoDesktop("41")}}{{CompatNo}}{{CompatOpera("38")}}{{CompatSafari("10")}}
Map() without new throws{{CompatVersionUnknown}}12{{ CompatGeckoDesktop("42") }}11{{CompatVersionUnknown}}{{CompatSafari("9")}}
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{ CompatChrome(38) }} [1]{{ CompatGeckoMobile("13") }}{{CompatNo}}{{CompatNo}}8
Constructor argument: new Map(iterable){{CompatNo}}{{ CompatChrome(38) }}{{ CompatGeckoMobile("13") }}{{CompatNo}}{{CompatNo}}9
iterable{{CompatNo}}{{CompatNo}}{{ CompatGeckoMobile("17") }}{{CompatNo}}{{CompatNo}}8
Map.clear(){{CompatNo}}{{ CompatChrome(31) }}
- {{ CompatChrome(38) }}		{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
Map.keys(), Map.values(), Map.entries(){{CompatNo}}{{ CompatChrome(37) }}
- {{ CompatChrome(38) }}		{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
Map.forEach(){{CompatNo}}{{ CompatChrome(36) }}
- {{ CompatChrome(38) }}		{{CompatGeckoMobile("25")}}{{CompatNo}}{{CompatNo}}8
Key equality for -0 and 0{{CompatNo}}{{ CompatChrome(34) }}
- {{ CompatChrome(38) }}		{{CompatGeckoMobile("29")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Constructor argument: new Map(null){{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("37")}}{{CompatUnknown}}{{CompatUnknown}}9
Monkey-patched set() in Constructor{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatGeckoMobile("37")}}{{CompatUnknown}}{{CompatUnknown}}9
Map[@@species]{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("41")}}{{CompatUnknown}}{{CompatUnknown}}10
Map() without new throws5.1{{CompatUnknown}}{{CompatGeckoMobile("42")}}{{CompatUnknown}}{{CompatUnknown}}9
-
- -

[1] Starting with Chrome 31, the feature was available behind a preference. In chrome://flags, activate the entry “Enable Experimental JavaScript”.

- -

Zobacz też

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/keys/index.html b/files/pl/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index 6d018a6f9a..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys -original_slug: Web/JavaScript/Referencje/Obiekty/Map/keys ---- -
{{JSRef}}
- -

Metoda keys() zwraca nowy obiekt typu Iterator, który zawiera klucze dla każdego elementu w Mapie. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

- -
myMap.keys()
- -

Zwracana wartość

- -

Nowy iterator obiektu typu {{jsxref("Map")}}

- -

Przykłady

- -

Używanie keys()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/set/index.html b/files/pl/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 96f3340090..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set -original_slug: Web/JavaScript/Referencje/Obiekty/Map/set ---- -
{{JSRef}}
- -

Metoda set() dodaje lub zmienia element o podany kluczu i wartości w Mapie. 

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

Składnia

- -
myMap.set(key, value);
- -

Parametry

- -
-
key
-
Wymagany. Klucz elementu, który zostanie dodany do Mapy.
-
value
-
Wymagany. Wartość elementu, który zostanie dodany do Mapy.
-
- -

Zwracana wartość

- -

 Obiekt typu Map.

- -

Przykłady

- -

Używanie set()

- -
var myMap = new Map();
-
-// Dodawanie nowych elementu
-myMap.set('bar', 'foo');
-myMap.set(1, 'foobar');
-
-// Zmiana istniejącego już elementu
-myMap.set('bar', 'baz');
-
- -

Używanie set w połączeniu z łańcuchowaniem

- -

Ponieważ set() zwraca ten sam obiekt typu Mapa, można użyć chainingu (uruchamianie metod jedna po drugiej na danym obiekcie przy użyciu kropek).

- -
// Dodawanie elementów do mapy za pomocą chainingu
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
-
-
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Definicja początowa.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/size/index.html b/files/pl/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 69a63c8aa0..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -tags: - - JavaScript - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size -original_slug: Web/JavaScript/Referencje/Obiekty/Map/size ---- -
{{JSRef}}
- -

Atrybut size zwraca ilość elementów znajdujących się w obiekcie {{jsxref("Map")}}.

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

Opis

- -

Wartość size to liczba reprezentująca ile elementów posiada obiekt Map. Funkcja set dla size to undefined; nie można edytować tego atrybutu.

- -

Przykłady

- -

Użycie size

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

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność

- - - -

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

- -

Zobacz także

- - diff --git a/files/pl/web/javascript/reference/global_objects/map/values/index.html b/files/pl/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 163f99de5d..0000000000 --- a/files/pl/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Mapa - - Metodă - - Prototyp -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values -original_slug: Web/JavaScript/Referencje/Obiekty/Map/values ---- -
{{JSRef}}
- -

Metoda values() zwraca nowy obiekt typu Iterator, który zawiera wartości dla każdego elementu w Mapie. Można się do nich odnieść w takiej kolejności, jakiej zostały wstawione.

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

Składnia

- -
myMap.values()
- -

Zwracana wartość

- -

Nowy iterator obiektu typu {{jsxref("Map")}}.

- -

Przykłady

- -

Używanie values()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

Specyfikacja

- - - - - - - - - - - - - - - - - - - -
SpecyfikacjaStatusKomentarz
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Definicja początkowa.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Kompatybilność z przeglądarkami

- - - -

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

- -

Zobacz również

- - diff --git a/files/pt-br/_redirects.txt b/files/pt-br/_redirects.txt index 250d4b01a5..5cdcfc9164 100644 --- a/files/pt-br/_redirects.txt +++ b/files/pt-br/_redirects.txt @@ -843,7 +843,18 @@ /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Boolean/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Boolean /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Function /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/get /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/has /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/set /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/size /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Map/values /pt-BR/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /pt-BR/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/prototype /pt-BR/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat diff --git a/files/pt-br/_wikihistory.json b/files/pt-br/_wikihistory.json index 737806411d..0cc1926851 100644 --- a/files/pt-br/_wikihistory.json +++ b/files/pt-br/_wikihistory.json @@ -13517,85 +13517,6 @@ "lucasmaiaesilva" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:43:23.476Z", - "contributors": [ - "mathvalenza", - "mateusvelleda", - "chapeupreto", - "mauricio.araldi", - "Klauswk", - "renatoluna", - "BernardoMariano", - "raduq", - "raphaelpor" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2019-03-23T22:13:54.269Z", - "contributors": [ - "renatoluna" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2019-05-29T19:41:42.276Z", - "contributors": [ - "renatoluna" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2019-03-23T22:13:54.600Z", - "contributors": [ - "renatoluna" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2019-09-16T15:32:37.374Z", - "contributors": [ - "cezinha", - "rodrigocnascimento", - "renatoluna" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T21:58:34.923Z", - "contributors": [ - "haskellcamargo" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2020-10-15T22:01:02.517Z", - "contributors": [ - "clovislima", - "MarcVFX" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2019-03-23T22:20:29.616Z", - "contributors": [ - "shuminyang" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2019-03-23T22:10:32.061Z", - "contributors": [ - "haskellcamargo", - "nanquim" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2019-03-18T20:56:12.542Z", - "contributors": [ - "mauricio.araldi", - "raduq" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2020-10-15T22:16:52.931Z", - "contributors": [ - "liddack" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2019-03-23T23:21:27.763Z", "contributors": [ @@ -17300,6 +17221,85 @@ "LuisAraujo" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:43:23.476Z", + "contributors": [ + "mathvalenza", + "mateusvelleda", + "chapeupreto", + "mauricio.araldi", + "Klauswk", + "renatoluna", + "BernardoMariano", + "raduq", + "raphaelpor" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2019-03-23T22:13:54.269Z", + "contributors": [ + "renatoluna" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2019-05-29T19:41:42.276Z", + "contributors": [ + "renatoluna" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2019-03-23T22:13:54.600Z", + "contributors": [ + "renatoluna" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2019-09-16T15:32:37.374Z", + "contributors": [ + "cezinha", + "rodrigocnascimento", + "renatoluna" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T21:58:34.923Z", + "contributors": [ + "haskellcamargo" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2020-10-15T22:01:02.517Z", + "contributors": [ + "clovislima", + "MarcVFX" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2019-03-23T22:20:29.616Z", + "contributors": [ + "shuminyang" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2019-03-23T22:10:32.061Z", + "contributors": [ + "haskellcamargo", + "nanquim" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2019-03-18T20:56:12.542Z", + "contributors": [ + "mauricio.araldi", + "raduq" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2020-10-15T22:16:52.931Z", + "contributors": [ + "liddack" + ] + }, "orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator": { "modified": "2020-10-15T22:12:37.977Z", "contributors": [ diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..393ee10017 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,120 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Prototipo + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

O método clear() remove todos os elementos de um objeto Map.

+ +

Sintaxe

+ +
meuMapa.clear();
+ +

Valor retornado

+ +

{{jsxref("undefined")}}.

+ +

Exemplos

+ +

Usando o método clear

+ +
var meuMapa = new Map();
+meuMapa.set('bar', 'baz');
+meuMapa.set(1, 'foo');
+
+meuMapa.size;       // 2
+meuMapa.has('bar'); // true
+
+meuMapa.clear();
+
+meuMapa.size;       // 0
+meuMapa.has('bar')  // false
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("19.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("19.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..41631bb2cc --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,121 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Prototipo + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

O método delete() remove o elemento especificado de um objeto Map.

+ +

Sintaxe

+ +
meuMapa.delete(chave);
+ +

Parâmetros

+ +
+
key
+
Obrigatório. A chave do elemento a ser removido do objeto Map.
+
+ +

Valor retornado

+ +

Retorna true se um elemento existia no objeto Map e foi removido, ou false se o elemento não existia.

+ +

Exemplos

+ +

Usando o método delete

+ +
var meuMapa = new Map();
+meuMapa.set('bar', 'foo');
+
+meuMapa.delete('bar'); // Retorna true. Removido com sucesso.
+meuMapa.has('bar');    // Retorna false. O elemento com valor "bar" já não existe mais no mapa.
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("13.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..8ca232d906 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,121 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - ECMAScript 2015 + - Iterador + - JavaScript + - Mapa + - Prototipo + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

O método entries() retorna um novo objeto Iterador que contém os pares [chave, valor] para cada elemento no objeto Map pela ordem de inserção.

+ +

Sintaxe

+ +
meuMapa.entries()
+ +

Retorna o valor

+ +

Um novo objeto iterador de {{jsxref("Map")}}.

+ +

Exemplos

+ +

Usando entries()

+ +
var meuMap = new Map();
+meuMap.set('0', 'foo');
+meuMap.set(1, 'bar');
+meuMap.set({}, 'baz');
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..c0387a1e74 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,147 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Mapa + - Prototipo + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

O método forEach() executa uma função fornecida uma vez para cada par de chave/valor no objeto Map, pela ordem de inserção.

+ +

Sintaxe

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

Parâmetros

+ +
+
callback
+
Função a ser executada para cada elemento.
+
thisArg
+
Valor a utilizar como o this quando estiver executando o callback.
+
+ +

Valor de retorno

+ +

{{jsxref("undefined")}}.

+ +

Descrição

+ +

O método forEach executa o callback fornecido uma vez para cada chave existente no mapa. Ele não é invocado para as chaves que foram removidas. No entanto, ele é executado para ítens que estão presentes mesmo com o valor undefined.

+ +

callback é invocado com três argumentos:

+ + + +

Se um parâmetro thisArg for fornecido ao forEach, ele será passado ao callback quando invocado, e será utilizado como o valor de seu this.  De outra forma, o valor undefined será passado como o valor de seu this.  O valor this observável em última instância por callback é determinado de acordo com as regras comuns para determinar o this sendo visto por uma função.

+ +

Cada valor é visitado uma vez, exceto para o caso em que ele foi removido e re-adicionado antes do forEach ter acabado de ser executado. o callback não é invocado para valores removidos antes de serem visitados. Novos valores adicionados antes do forEach ter acabado serão visitados.

+ +

forEach executa a função de callback uma vez para cada elemento no objeto Map; ele não retorna um valor.

+ +

Exemplos

+ +

Imprimindo o conteúdo de um objeto Map

+ +

O código a seguir registra uma linha de log para cada elemento no objeto Map:

+ +
function registrarElementosDoMapa(valor, chave, mapa) {
+    console.log(`m[${chave}] = ${valor}`);
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(registrarElementosDoMapa);
+// logs:
+// "m[foo] = 3"
+// "m[bar] = [object Object]"
+// "m[baz] = undefined"
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
+ +

Compatibilidade com os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("25.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("25.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..9c8b66e302 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,75 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Prototype + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

O método get() retorna um elemento específico de um objeto de Map.

+ +

Sintaxe

+ +
myMap.get(chave);
+ +

Parâmetros

+ +
+
chave
+
Obrigatório. A chave do elemento para retornar do objeto de Map.
+
+ +

Valor de retorno

+ +

Retorna o elemento associado com a chave específica ou undefined se a chave não puder ser encontrada no objeto de Map.

+ +

Exemplos

+ +

Usando o métodoget

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');  // Retorna "foo".
+myMap.get('baz');  // Retorna undefined.
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com navegadores

+ +

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

+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..c929b131d7 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

O método has() retorna um valor booleano indicando quando um elemento com a chave especificada existe ou não

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

Sintaxe

+ +
myMap.has(key);
+ +

Parametros

+ +
+
key
+
Necessário. A chave para verificar a presença do elemento no objeto Map.
+
+ +

Valor retornado

+ +
+
Booleano
+
Retorna true se um elemento com a chave especificada existe no objeto Map; caso contrário: false.
+
+ +

Exemplos

+ +

Usando o método has

+ +
var myMap = new Map();
+myMap.set('bar', "foo");
+
+myMap.has('bar');  // retorna true
+myMap.has('foo'); // retorna false
+myMap.has('barz');  // retorna false
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}}
+ +

Compatibilidade com navegadores

+ +

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

+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..cf8c3bfab2 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,226 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Mapa +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +

O objeto Map é um mapa simples de chave/valor. Qualquer valor (objeto e {{Glossary("Primitive", "valores primitivos")}}) pode ser usado como uma chave ou um valor.

+ +

Sintaxe

+ +
new Map([iterable])
+
+ +

Parâmetros

+ +
+
iterable
+
+

Iterable é um Array ou outro objeto iterável cujos elementos são pares de chave-valor (2-element Arrays). Cada par de chave-valor é adicionado ao novo Map. null é tratado como undefined.

+
+
+ +

Descrição

+ +

Um objeto Map itera seus elementos em ordem de inserção — um loop {{jsxref("Statements/for...of", "for...of")}} retorna um array de [chave, valor] para cada iteração.

+ +

Deve-se notar que um Map que é um mapa de um objeto, especialmente, um dicionário de dicionários somente irá mapear apenas para a ordem de inserção -- que é aleatória e não ordenada.

+ +

Igualidade de valores

+ +

A igualdade das chaves é baseada no algoritmo "SameValueZero" (mesmo valor): NaN é considerado igual à NaN (mesmo que NaN !== NaN) e todos os outros valores são considerados iguals de acordo com a semantica do operador ===. Em versões anteriores do rascunho ECMAScript 2015 draft -0 and +0 eram considerados diferentes (mesmo que -0 === +0), isto foi trocado em versões posteriores e foi aplicado no Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) e em uma build recente nightly do Chrome.

+ +

Objetos e mapas comparados

+ +

{{jsxref("Object", "Objects")}} são similares a Maps onde ambos deixam adicionar chaves para valores, recuperar estes valores, apagar chaves, e detectar quando algo foi adicionado em uma chave. Por causa disso (e porque não existem alternativas pré-construidas), Objects historicamente foram usados como Maps; no entanto, existem diferenças importantes entre Objects e Maps que fazem o uso do Map melhor:

+ + + +

Isto não significa que você deve usar Maps em todo lugar, objetos ainda serão usados na maioria dos casos. Instancias de Map são úteis somente para coleções, e você deve considerar adaptar seu codigo onde você usou objetos para isto anteriormente. Objects devem ser usados como registros, com campos e métodos.
+ Se você não tem certeza qual usar, pergunte-se as seguintes questões:

+ + + +

Se você respondeu "sim" em qualquer uma dessas questões, é um sinal de que você quer utilizar um  Map. Se ao invés disto você tem um numero fixo de keys, trabalhe eles individualmente, e faça diferenciação entre o uso deles, você quer um objeto.

+ +

Propriedades

+ +
+
Map.length
+
O tamanho do mapa é 0.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
A função construtora que é usada para criar objetos derivados.
+
{{jsxref("Map.prototype")}}
+
Representa o prototype para o construtor de Map. Permite a adição de propriedades para todos os objetos Map.
+
+ +

Instâncias de Map

+ +

Todas as instancias de Map herdam de {{jsxref("Map.prototype")}}.

+ +

Propriedades

+ +

{{page('pt-BR/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

+ +

Métodos

+ +

{{page('pt-BR/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

+ +

Exemplos

+ +

Usando o objeto Map

+ +
var myMap = new Map();
+
+var keyString = "uma string",
+    keyObj = {},
+    keyFunc = function () {};
+
+// configurando os valores
+myMap.set(keyString, "valor associado com 'uma string'");
+myMap.set(keyObj, "valor associado com keyObj");
+myMap.set(keyFunc, "valor associado com keyFunc");
+
+myMap.size; // 3
+
+// obtendo os valores
+myMap.get(keyString);    // "valor associado com 'uma string'"
+myMap.get(keyObj);       // "valor associado com keyObj"
+myMap.get(keyFunc);      // "valor associado com keyFunc"
+
+myMap.get("uma string"); // "valor associado com 'uma string'"
+                         // pois keyString === 'uma string'
+myMap.get({});           // undefined, pois keyObj !== {}
+myMap.get(function() {}) // undefined, pois keyFunc !== function () {}
+
+ +

Usando NaN como Map keys

+ +

NaN pode também ser usado como key. Mesmo que NaN não seja igual a ele mesmo (NaN !== NaN)  é true, o seguinte exemplo funciona, porquê NaNs são indistinguíveis uma para o outro:

+ +
var myMap = new Map();
+myMap.set(NaN, "not a number");
+
+myMap.get(NaN); // "not a number"
+
+var otherNaN = Number("foo");
+myMap.get(otherNaN); // "not a number"
+
+ +

Iterando Maps com for..of

+ +

Maps podem ser iterados usando um for..of :

+ +
var myMap = new Map();
+myMap.set(0, "zero");
+myMap.set(1, "um");
+for (var [key, value] of myMap) {
+  console.log(key + " = " + value);
+}
+// 0 = zero
+// 1 = um
+
+for (var key of myMap.keys()) {
+  console.log(key);
+}
+// 0
+// 1
+
+for (var value of myMap.values()) {
+  console.log(value);
+}
+// zero
+// um
+
+for (var [key, value] of myMap.entries()) {
+  console.log(key + " = " + value);
+}
+// 0 = zero
+// 1 = um
+
+ +

Iterando Maps com forEach()

+ +

Maps podem ser iterados usando um forEach():

+ +
myMap.forEach(function(value, key) {
+  console.log(key + " = " + value);
+}, myMap)
+// Mostrará 2 logs; o primeiro com "0 = zero" e o segundo com "1 = um"
+
+ +

Relação com objetos Array

+ +
var kvArray = [["key1", "value1"], ["key2", "value2"]];
+
+// Utiliza o construtor padrão de Map para converter um Array de 2 dimensões de chave-valor Array em um mapa
+var myMap = new Map(kvArray);
+
+myMap.get("key1"); // retorna "value1"
+
+// Utiliza Array.from para converter um mapa em um Array de 2 dimensões de chave-valor
+console.log(Array.from(myMap)) // Mostrará exatamente o mesmo Array que kvArray
+
+// Uma forma mais sucinta de realizar a mesma conversão com o operador spread
+console.log([...myMap]);
+
+// Ou usa o operador spread nas chaves ou valores para o iterador pegar
+// um array com somente as chaves ou valores
+console.log([...myMap.keys()]); // Mostrará ["key1", "key2"]
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES6', '#sec-map-objects', 'Map')}}{{Spec2('ES6')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
+ +

Compatibilidade com os navegadores

+ +

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

+ +

[1] Começando com Chrome 31, a feature ficou disponível sob modificação de configurações. Em chrome://flags, ative a entrada activate “Enable Experimental JavaScript”.

+ +

Ver também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..1a68389071 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,116 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +
O método keys() retorna um novo objeto do tipo Iterator que contem uma chave para cada elemento dentro do objeto Map na ordem que foram inseridos.
+ +

 

+ +

Sintaxe

+ +
myMap.keys()
+ +

Tipo de Retorno

+ +

Um novo objeto {{jsxref("Map")}}.

+ +

Exemplos

+ +

Usando keys()

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES6')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
+
+ +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..e381342aba --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,138 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Prototype + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

O método set() adiciona ou atualiza um elemento com uma chave e valor específicos a um objeto de Map.

+ +

Sintaxe

+ +
myMap.set(chave, valor);
+ +

Parâmetros

+ +
+
chave
+
Obrigatório. A chave do elemento para adicionar ao objeto de Map.
+
valor
+
Obrigatório. O valor do elemento para adicionar ao objeto de Map.
+
+ +

Valor de retorno

+ +

O objeto de Map.

+ +

Exemplos

+ +

Usando o método set 

+ +
var myMap = new Map();
+
+// adiciona novos elementos ao map
+myMap.set('bar', 'foo');
+myMap.set(1, 'foobar');
+
+// Atualiza um elemento no map
+myMap.set('bar', 'baz');
+
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Definição    inicial.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade de navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatVersionUnknown}}{{CompatGeckoDesktop("13.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatVersionUnknown}}{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Notas sobre compatibilidade

+ + + +

Veja também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..f174ba9976 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,111 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

A propriedade de acesso size retorna o número de elementos em um objeto {{jsxref("Map")}}.

+ +

Descrição

+ +

O valor de size é um integer representando quantas entradas o objeto Map tem. Uma function set de acesso ao size é undefined; você não pode trocar esta propriedade.

+ +

Exemplos

+ +

Usando size

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

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Definição Inicial.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade com os navegadores

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("19") }}{{ CompatIE("11") }}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
+
+ +

Gecko - Notas específicas

+ + + +

Ver também

+ + diff --git a/files/pt-br/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..67c68e2437 --- /dev/null +++ b/files/pt-br/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,75 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +tags: + - Iterador + - Mapa + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

O método values() retorna um novo objeto Iterator que contém os valores de cada elemento do objeto Map em ordem de inserção.

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

Sintaxe

+ +
meuMap.values()
+ +

Valor de retorno

+ +

Um novo objeto iterador do {{jsxref("Map")}}.

+ +

Exemplos

+ +

Usando o values()

+ +
var meuMap = new Map();
+meuMap.set('0', 'foo');
+meuMap.set(1, 'bar');
+meuMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

Especificações

+ + + + + + + + + + + + + + + + + + + +
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

Compatibilidade de navegadores

+ + + +

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

+ +

Veja também

+ + diff --git a/files/pt-br/web/javascript/reference/global_objects/map/clear/index.html b/files/pt-br/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 19482e19c8..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

O método clear() remove todos os elementos de um objeto Map.

- -

Sintaxe

- -
meuMapa.clear();
- -

Valor retornado

- -

{{jsxref("undefined")}}.

- -

Exemplos

- -

Usando o método clear

- -
var meuMapa = new Map();
-meuMapa.set('bar', 'baz');
-meuMapa.set(1, 'foo');
-
-meuMapa.size;       // 2
-meuMapa.has('bar'); // true
-
-meuMapa.clear();
-
-meuMapa.size;       // 0
-meuMapa.has('bar')  // false
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com os navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("19.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("19.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/delete/index.html b/files/pt-br/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index f4b0ae0786..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

O método delete() remove o elemento especificado de um objeto Map.

- -

Sintaxe

- -
meuMapa.delete(chave);
- -

Parâmetros

- -
-
key
-
Obrigatório. A chave do elemento a ser removido do objeto Map.
-
- -

Valor retornado

- -

Retorna true se um elemento existia no objeto Map e foi removido, ou false se o elemento não existia.

- -

Exemplos

- -

Usando o método delete

- -
var meuMapa = new Map();
-meuMapa.set('bar', 'foo');
-
-meuMapa.delete('bar'); // Retorna true. Removido com sucesso.
-meuMapa.has('bar');    // Retorna false. O elemento com valor "bar" já não existe mais no mapa.
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com os navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("13.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/entries/index.html b/files/pt-br/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index cdea688bf2..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - ECMAScript 2015 - - Iterador - - JavaScript - - Mapa - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

O método entries() retorna um novo objeto Iterador que contém os pares [chave, valor] para cada elemento no objeto Map pela ordem de inserção.

- -

Sintaxe

- -
meuMapa.entries()
- -

Retorna o valor

- -

Um novo objeto iterador de {{jsxref("Map")}}.

- -

Exemplos

- -

Usando entries()

- -
var meuMap = new Map();
-meuMap.set('0', 'foo');
-meuMap.set(1, 'bar');
-meuMap.set({}, 'baz');
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com os navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20")}}{{CompatNo}}{{CompatNo}}8
-
- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/foreach/index.html b/files/pt-br/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index 1aed37b31c..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript 2015 - - JavaScript - - Mapa - - Prototipo - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

O método forEach() executa uma função fornecida uma vez para cada par de chave/valor no objeto Map, pela ordem de inserção.

- -

Sintaxe

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

Parâmetros

- -
-
callback
-
Função a ser executada para cada elemento.
-
thisArg
-
Valor a utilizar como o this quando estiver executando o callback.
-
- -

Valor de retorno

- -

{{jsxref("undefined")}}.

- -

Descrição

- -

O método forEach executa o callback fornecido uma vez para cada chave existente no mapa. Ele não é invocado para as chaves que foram removidas. No entanto, ele é executado para ítens que estão presentes mesmo com o valor undefined.

- -

callback é invocado com três argumentos:

- - - -

Se um parâmetro thisArg for fornecido ao forEach, ele será passado ao callback quando invocado, e será utilizado como o valor de seu this.  De outra forma, o valor undefined será passado como o valor de seu this.  O valor this observável em última instância por callback é determinado de acordo com as regras comuns para determinar o this sendo visto por uma função.

- -

Cada valor é visitado uma vez, exceto para o caso em que ele foi removido e re-adicionado antes do forEach ter acabado de ser executado. o callback não é invocado para valores removidos antes de serem visitados. Novos valores adicionados antes do forEach ter acabado serão visitados.

- -

forEach executa a função de callback uma vez para cada elemento no objeto Map; ele não retorna um valor.

- -

Exemplos

- -

Imprimindo o conteúdo de um objeto Map

- -

O código a seguir registra uma linha de log para cada elemento no objeto Map:

- -
function registrarElementosDoMapa(valor, chave, mapa) {
-    console.log(`m[${chave}] = ${valor}`);
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(registrarElementosDoMapa);
-// logs:
-// "m[foo] = 3"
-// "m[bar] = [object Object]"
-// "m[baz] = undefined"
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}}
- -

Compatibilidade com os navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("25.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("25.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/get/index.html b/files/pt-br/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index ef7db5c8fa..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Prototype - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

O método get() retorna um elemento específico de um objeto de Map.

- -

Sintaxe

- -
myMap.get(chave);
- -

Parâmetros

- -
-
chave
-
Obrigatório. A chave do elemento para retornar do objeto de Map.
-
- -

Valor de retorno

- -

Retorna o elemento associado com a chave específica ou undefined se a chave não puder ser encontrada no objeto de Map.

- -

Exemplos

- -

Usando o métodoget

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');  // Retorna "foo".
-myMap.get('baz');  // Retorna undefined.
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com navegadores

- -

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

- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/has/index.html b/files/pt-br/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index bc110f3087..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

O método has() retorna um valor booleano indicando quando um elemento com a chave especificada existe ou não

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

Sintaxe

- -
myMap.has(key);
- -

Parametros

- -
-
key
-
Necessário. A chave para verificar a presença do elemento no objeto Map.
-
- -

Valor retornado

- -
-
Booleano
-
Retorna true se um elemento com a chave especificada existe no objeto Map; caso contrário: false.
-
- -

Exemplos

- -

Usando o método has

- -
var myMap = new Map();
-myMap.set('bar', "foo");
-
-myMap.has('bar');  // retorna true
-myMap.has('foo'); // retorna false
-myMap.has('barz');  // retorna false
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}}
- -

Compatibilidade com navegadores

- -

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

- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/index.html b/files/pt-br/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 80ec04af62..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,225 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Mapa -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -

O objeto Map é um mapa simples de chave/valor. Qualquer valor (objeto e {{Glossary("Primitive", "valores primitivos")}}) pode ser usado como uma chave ou um valor.

- -

Sintaxe

- -
new Map([iterable])
-
- -

Parâmetros

- -
-
iterable
-
-

Iterable é um Array ou outro objeto iterável cujos elementos são pares de chave-valor (2-element Arrays). Cada par de chave-valor é adicionado ao novo Map. null é tratado como undefined.

-
-
- -

Descrição

- -

Um objeto Map itera seus elementos em ordem de inserção — um loop {{jsxref("Statements/for...of", "for...of")}} retorna um array de [chave, valor] para cada iteração.

- -

Deve-se notar que um Map que é um mapa de um objeto, especialmente, um dicionário de dicionários somente irá mapear apenas para a ordem de inserção -- que é aleatória e não ordenada.

- -

Igualidade de valores

- -

A igualdade das chaves é baseada no algoritmo "SameValueZero" (mesmo valor): NaN é considerado igual à NaN (mesmo que NaN !== NaN) e todos os outros valores são considerados iguals de acordo com a semantica do operador ===. Em versões anteriores do rascunho ECMAScript 2015 draft -0 and +0 eram considerados diferentes (mesmo que -0 === +0), isto foi trocado em versões posteriores e foi aplicado no Gecko 29 {{geckoRelease("29")}} ({{bug("952870")}}) e em uma build recente nightly do Chrome.

- -

Objetos e mapas comparados

- -

{{jsxref("Object", "Objects")}} são similares a Maps onde ambos deixam adicionar chaves para valores, recuperar estes valores, apagar chaves, e detectar quando algo foi adicionado em uma chave. Por causa disso (e porque não existem alternativas pré-construidas), Objects historicamente foram usados como Maps; no entanto, existem diferenças importantes entre Objects e Maps que fazem o uso do Map melhor:

- - - -

Isto não significa que você deve usar Maps em todo lugar, objetos ainda serão usados na maioria dos casos. Instancias de Map são úteis somente para coleções, e você deve considerar adaptar seu codigo onde você usou objetos para isto anteriormente. Objects devem ser usados como registros, com campos e métodos.
- Se você não tem certeza qual usar, pergunte-se as seguintes questões:

- - - -

Se você respondeu "sim" em qualquer uma dessas questões, é um sinal de que você quer utilizar um  Map. Se ao invés disto você tem um numero fixo de keys, trabalhe eles individualmente, e faça diferenciação entre o uso deles, você quer um objeto.

- -

Propriedades

- -
-
Map.length
-
O tamanho do mapa é 0.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
A função construtora que é usada para criar objetos derivados.
-
{{jsxref("Map.prototype")}}
-
Representa o prototype para o construtor de Map. Permite a adição de propriedades para todos os objetos Map.
-
- -

Instâncias de Map

- -

Todas as instancias de Map herdam de {{jsxref("Map.prototype")}}.

- -

Propriedades

- -

{{page('pt-BR/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

- -

Métodos

- -

{{page('pt-BR/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

- -

Exemplos

- -

Usando o objeto Map

- -
var myMap = new Map();
-
-var keyString = "uma string",
-    keyObj = {},
-    keyFunc = function () {};
-
-// configurando os valores
-myMap.set(keyString, "valor associado com 'uma string'");
-myMap.set(keyObj, "valor associado com keyObj");
-myMap.set(keyFunc, "valor associado com keyFunc");
-
-myMap.size; // 3
-
-// obtendo os valores
-myMap.get(keyString);    // "valor associado com 'uma string'"
-myMap.get(keyObj);       // "valor associado com keyObj"
-myMap.get(keyFunc);      // "valor associado com keyFunc"
-
-myMap.get("uma string"); // "valor associado com 'uma string'"
-                         // pois keyString === 'uma string'
-myMap.get({});           // undefined, pois keyObj !== {}
-myMap.get(function() {}) // undefined, pois keyFunc !== function () {}
-
- -

Usando NaN como Map keys

- -

NaN pode também ser usado como key. Mesmo que NaN não seja igual a ele mesmo (NaN !== NaN)  é true, o seguinte exemplo funciona, porquê NaNs são indistinguíveis uma para o outro:

- -
var myMap = new Map();
-myMap.set(NaN, "not a number");
-
-myMap.get(NaN); // "not a number"
-
-var otherNaN = Number("foo");
-myMap.get(otherNaN); // "not a number"
-
- -

Iterando Maps com for..of

- -

Maps podem ser iterados usando um for..of :

- -
var myMap = new Map();
-myMap.set(0, "zero");
-myMap.set(1, "um");
-for (var [key, value] of myMap) {
-  console.log(key + " = " + value);
-}
-// 0 = zero
-// 1 = um
-
-for (var key of myMap.keys()) {
-  console.log(key);
-}
-// 0
-// 1
-
-for (var value of myMap.values()) {
-  console.log(value);
-}
-// zero
-// um
-
-for (var [key, value] of myMap.entries()) {
-  console.log(key + " = " + value);
-}
-// 0 = zero
-// 1 = um
-
- -

Iterando Maps com forEach()

- -

Maps podem ser iterados usando um forEach():

- -
myMap.forEach(function(value, key) {
-  console.log(key + " = " + value);
-}, myMap)
-// Mostrará 2 logs; o primeiro com "0 = zero" e o segundo com "1 = um"
-
- -

Relação com objetos Array

- -
var kvArray = [["key1", "value1"], ["key2", "value2"]];
-
-// Utiliza o construtor padrão de Map para converter um Array de 2 dimensões de chave-valor Array em um mapa
-var myMap = new Map(kvArray);
-
-myMap.get("key1"); // retorna "value1"
-
-// Utiliza Array.from para converter um mapa em um Array de 2 dimensões de chave-valor
-console.log(Array.from(myMap)) // Mostrará exatamente o mesmo Array que kvArray
-
-// Uma forma mais sucinta de realizar a mesma conversão com o operador spread
-console.log([...myMap]);
-
-// Ou usa o operador spread nas chaves ou valores para o iterador pegar
-// um array com somente as chaves ou valores
-console.log([...myMap.keys()]); // Mostrará ["key1", "key2"]
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES6', '#sec-map-objects', 'Map')}}{{Spec2('ES6')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

Compatibilidade com os navegadores

- -

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

- -

[1] Começando com Chrome 31, a feature ficou disponível sob modificação de configurações. Em chrome://flags, ative a entrada activate “Enable Experimental JavaScript”.

- -

Ver também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/keys/index.html b/files/pt-br/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index 907301897e..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{JSRef}}
- -
O método keys() retorna um novo objeto do tipo Iterator que contem uma chave para cada elemento dentro do objeto Map na ordem que foram inseridos.
- -

 

- -

Sintaxe

- -
myMap.keys()
- -

Tipo de Retorno

- -

Um novo objeto {{jsxref("Map")}}.

- -

Exemplos

- -

Usando keys()

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES6')}}Definição inicial.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatGeckoDesktop("20")}}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
-
- -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/set/index.html b/files/pt-br/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 2f50555333..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Prototype - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

O método set() adiciona ou atualiza um elemento com uma chave e valor específicos a um objeto de Map.

- -

Sintaxe

- -
myMap.set(chave, valor);
- -

Parâmetros

- -
-
chave
-
Obrigatório. A chave do elemento para adicionar ao objeto de Map.
-
valor
-
Obrigatório. O valor do elemento para adicionar ao objeto de Map.
-
- -

Valor de retorno

- -

O objeto de Map.

- -

Exemplos

- -

Usando o método set 

- -
var myMap = new Map();
-
-// adiciona novos elementos ao map
-myMap.set('bar', 'foo');
-myMap.set(1, 'foobar');
-
-// Atualiza um elemento no map
-myMap.set('bar', 'baz');
-
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Definição    inicial.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade de navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{CompatVersionUnknown}}{{CompatGeckoDesktop("13.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatVersionUnknown}}{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

Notas sobre compatibilidade

- - - -

Veja também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/size/index.html b/files/pt-br/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 6ce3b4ff7a..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

A propriedade de acesso size retorna o número de elementos em um objeto {{jsxref("Map")}}.

- -

Descrição

- -

O valor de size é um integer representando quantas entradas o objeto Map tem. Uma function set de acesso ao size é undefined; você não pode trocar esta propriedade.

- -

Exemplos

- -

Usando size

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

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Definição Inicial.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade com os navegadores

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("19") }}{{ CompatIE("11") }}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{CompatGeckoMobile("19")}}{{CompatNo}}{{CompatNo}}8
-
- -

Gecko - Notas específicas

- - - -

Ver também

- - diff --git a/files/pt-br/web/javascript/reference/global_objects/map/values/index.html b/files/pt-br/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 8bb1e96bca..0000000000 --- a/files/pt-br/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -tags: - - Iterador - - Mapa - - metodo -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
{{JSRef}}
- -

O método values() retorna um novo objeto Iterator que contém os valores de cada elemento do objeto Map em ordem de inserção.

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

Sintaxe

- -
meuMap.values()
- -

Valor de retorno

- -

Um novo objeto iterador do {{jsxref("Map")}}.

- -

Exemplos

- -

Usando o values()

- -
var meuMap = new Map();
-meuMap.set('0', 'foo');
-meuMap.set(1, 'bar');
-meuMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

Especificações

- - - - - - - - - - - - - - - - - - - -
EspecificaçãoStatusComentário
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Compatibilidade de navegadores

- - - -

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

- -

Veja também

- - diff --git a/files/ru/_redirects.txt b/files/ru/_redirects.txt index 19d8e65946..d45edc4187 100644 --- a/files/ru/_redirects.txt +++ b/files/ru/_redirects.txt @@ -435,6 +435,7 @@ /ru/docs/Web/API/Node.replaceChild /ru/docs/Web/API/Node/replaceChild /ru/docs/Web/API/Node.textContent /ru/docs/Web/API/Node/textContent /ru/docs/Web/API/Node/baseURIObject /ru/docs/conflicting/Web/API/Node +/ru/docs/Web/API/Node/getUserData /ru/docs/orphaned/Web/API/Node/getUserData /ru/docs/Web/API/Node/innerText /ru/docs/Web/API/HTMLElement/innerText /ru/docs/Web/API/Node/localName /ru/docs/Web/API/Element/localName /ru/docs/Web/API/Node/namespaceURI /ru/docs/Web/API/Element/namespaceURI @@ -757,7 +758,19 @@ /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/ListFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/get /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/has /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /ru/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/set /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/size /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/values /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /ru/docs/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ /ru/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat diff --git a/files/ru/_wikihistory.json b/files/ru/_wikihistory.json index 8a2eb565d4..6ff6ec06eb 100644 --- a/files/ru/_wikihistory.json +++ b/files/ru/_wikihistory.json @@ -9970,12 +9970,6 @@ "AlexAlex" ] }, - "Web/API/Node/getUserData": { - "modified": "2019-03-23T22:53:29.815Z", - "contributors": [ - "AlexAlex" - ] - }, "Web/API/Node/hasChildNodes": { "modified": "2019-03-23T22:53:39.791Z", "contributors": [ @@ -20065,100 +20059,6 @@ "fullfs" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:31:18.471Z", - "contributors": [ - "altpoint", - "AndreyGlyan", - "fanich37", - "Dzvonek", - "teryaew", - "xobotyi", - "akmil", - "SphinxKnight", - "WispProxy", - "dtretyakov" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@species": { - "modified": "2019-03-23T22:09:16.930Z", - "contributors": [ - "WispProxy", - "ahtohbi4" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2019-03-23T22:11:36.456Z", - "contributors": [ - "thepocp" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T21:50:15.883Z", - "contributors": [ - "xobotyi", - "ahtohbi4", - "vesai" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2019-09-29T09:44:45.397Z", - "contributors": [ - "evvs", - "rsarov", - "ahtohbi4" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T21:49:44.007Z", - "contributors": [ - "swa1ps", - "trueanqu", - "SomeoneDeployMe" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T21:55:36.338Z", - "contributors": [ - "dimon4ezzz", - "AndreyLipin", - "ahtohbi4" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2019-03-23T22:18:58.841Z", - "contributors": [ - "Ignat86" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2019-03-23T22:09:06.332Z", - "contributors": [ - "ahtohbi4" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2019-07-08T16:59:23.175Z", - "contributors": [ - "elrostov", - "InoY", - "ahtohbi4" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2020-11-28T13:51:01.575Z", - "contributors": [ - "ialexi-bl", - "Yumeiro", - "reilag" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2019-03-23T22:09:12.314Z", - "contributors": [ - "ahtohbi4" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:26:14.248Z", "contributors": [ @@ -25432,6 +25332,12 @@ "curdwithraisins" ] }, + "orphaned/Web/API/Node/getUserData": { + "modified": "2019-03-23T22:53:29.815Z", + "contributors": [ + "AlexAlex" + ] + }, "orphaned/Web/API/Notation": { "modified": "2020-10-15T22:17:39.773Z", "contributors": [ @@ -25697,6 +25603,100 @@ "AliaksandrZahorski" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:31:18.471Z", + "contributors": [ + "altpoint", + "AndreyGlyan", + "fanich37", + "Dzvonek", + "teryaew", + "xobotyi", + "akmil", + "SphinxKnight", + "WispProxy", + "dtretyakov" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species": { + "modified": "2019-03-23T22:09:16.930Z", + "contributors": [ + "WispProxy", + "ahtohbi4" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2019-03-23T22:11:36.456Z", + "contributors": [ + "thepocp" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T21:50:15.883Z", + "contributors": [ + "xobotyi", + "ahtohbi4", + "vesai" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2019-09-29T09:44:45.397Z", + "contributors": [ + "evvs", + "rsarov", + "ahtohbi4" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T21:49:44.007Z", + "contributors": [ + "swa1ps", + "trueanqu", + "SomeoneDeployMe" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T21:55:36.338Z", + "contributors": [ + "dimon4ezzz", + "AndreyLipin", + "ahtohbi4" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2019-03-23T22:18:58.841Z", + "contributors": [ + "Ignat86" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2019-03-23T22:09:06.332Z", + "contributors": [ + "ahtohbi4" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2019-07-08T16:59:23.175Z", + "contributors": [ + "elrostov", + "InoY", + "ahtohbi4" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2020-11-28T13:51:01.575Z", + "contributors": [ + "ialexi-bl", + "Yumeiro", + "reilag" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2019-03-23T22:09:12.314Z", + "contributors": [ + "ahtohbi4" + ] + }, "orphaned/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_": { "modified": "2019-03-23T22:37:24.165Z", "contributors": [ diff --git a/files/ru/orphaned/web/api/node/getuserdata/index.html b/files/ru/orphaned/web/api/node/getuserdata/index.html new file mode 100644 index 0000000000..949bc17fd7 --- /dev/null +++ b/files/ru/orphaned/web/api/node/getuserdata/index.html @@ -0,0 +1,64 @@ +--- +title: Node.getUserData() +slug: orphaned/Web/API/Node/getUserData +translation_of: Web/API/Node/getUserData +original_slug: Web/API/Node/getUserData +--- +

{{APIRef("DOM")}}{{ obsolete_header() }}

+ +

Метод Node.getUserData() возвращает любого пользователя {{domxref("DOMUserData")}} установленного предварительно на данном узле через {{domxref("Node.setUserData()")}}.

+ +
+

Методы Node.setUserData и {{domxref("Node.getUserData")}} больше не доступны для веб-контента. {{domxref("Element.dataset")}} или WeakMap могут быть использованы вместо него.

+
+ +

Синтаксис

+ +
userData = someNode.getUserData(userKey);
+ +

Параметры

+ + + +

Пример

+ +
var d = document.setUserData('key', 15, null);
+alert(document.getUserData('key')); // 15
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Удалено из спецификации
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Изначальное описание
+ +

Совместимость с браузерами

+ +

{{Compat("api.Node.getUserData")}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html new file mode 100644 index 0000000000..fb101362a7 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html @@ -0,0 +1,64 @@ +--- +title: get Map[@@species] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species +--- +
{{JSRef}}
+ +

Акцессор свойства Map[@@species] возвращает Map конструктор.

+ +

Синтаксис

+ +
Map[Symbol.species]
+
+ +

Описание

+ +

Акцессор свойства species, возвращает конструктор по умолчанию для Map объектов. Конструкторы подклассов могут переопределить его, чтобы изменить поведение конструктора.

+ +

Примеры

+ +

Свойство species возвращает конструктор по умолчанию, который является конструктором Map для Map объектов:

+ +
Map[Symbol.species]; // функция Map()
+ +

В производном объекте коллекции (например, ваша пользовательская карта MyMap), MyMap species является MyMap конструктором. Однако, вы можете захотеть переопределить это, что бы вернуть родительский Map в методах вашего производного класса:

+ +
class MyMap extends Map {
+  // Перезаписываем MyMap species на родительский Map конструктор
+  static get [Symbol.species]() { return Map; }
+}
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Исходное определение.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
+ +

Поддержка браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..5d9c518a05 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,72 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript6 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

Метод clear() удаляет все элементы из объекта Map.

+ +

Синтаксис

+ +
myMap.clear();
+ +

Возвращаемое значение

+ +

{{jsxref("undefined")}}.

+ +

Примеры

+ +

Использование метода clear

+ +
var myMap = new Map();
+myMap.set('bar', 'baz');
+myMap.set(1, 'foo');
+
+myMap.size;       // 2
+myMap.has('bar'); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has('bar')  // false
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

Совместимость с браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..7f52de0c89 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Ссылка + - метод + - прототип +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

Метод delete() удаляет указанный элемент из объекта {{jsxref("Map")}}.

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

Синтаксис

+ +
myMap.delete(key);
+ +

Параметры

+ +
+
key
+
Ключ элемента удаляемого из объекта {{jsxref("Map")}}
+
+ +

Возвращаемое значение

+ +

true если элемент существовал в {{jsxref("Map")}} и он был удалён или false если элемента с таким ключом не было.

+ +

Примеры

+ +

Использование метода delete

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.delete("bar"); // Возвращает true. Успешно удалён.
+myMap.has("bar");    // Возвращает false. Элемента "bar" больше нет.
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}}
+ +

Совместимость с браузерами

+

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

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..c1d3faf3d3 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,76 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

Метод entries() возвращает новый Итератор, содержащий пары [key, value] для каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.

+ +

Исходный код всех примеров для  {{jsxref("Map")}} сохранён на GitHub https://github.com/mdn/interactive-examples/tree/master/live-examples/js-examples/map.

+ +

Вы можете внести свой вклад, для этого: 

+ +

1. Клонируйте https://github.com/mdn/interactive-examples

+ +

2. Ознакомьтесь с руководством https://github.com/mdn/interactive-examples/blob/master/CONTRIBUTING.md

+ +

3. Напишите свой пример и отправьте нам запрос на извлечение.

+ +

Синтаксис

+ +
myMap.entries()
+ +

Возвращаемое значение

+ +

Новый итератор объекта {{jsxref("Map")}}.

+ +

Примеры

+ +

Использование entries()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}}
+ +

Поддержка браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..b2f99f9f47 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,95 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

Метод forEach() выполняет переданную функцию единожды для каждой пары ключ/значение объекта Map в порядке их вставки.

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

Синтаксис

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

Параметры

+ +
+
callback
+
Функция, которая будет выполнена для каждого элемента.
+
thisArg
+
Значение, которое будет использовано в качестве текущего при выполнении callback.
+
+ +

Возвращаемое значение

+ +

{{jsxref("undefined")}}.

+ +

Описание

+ +

Метод forEach выполняет переданный ему callback по разу для каждого фактически существующего ключа в наборе. Callback не вызывается для ключей, которые были удалены. Однако, он выполняется для элементов со значением undefined.

+ +

При вызове callback используются три аргумента:

+ + + +

Если аргумент thisArg указан для forEach, то при вызове callback он будет передан в качестве значения this.  В противном случае для this будет передано undefined. Значение this, в конечном итоге наблюдаемое в функции callback, определяется в соответствии c обычными правилами определения this в функции.

+ +

Каждое значение посещается один раз, за исключением случая, когда оно было удалено и добавлено снова до завершения forEach. callback не вызывается для значений, удалённых до их посещения. Новые значения будут посещены, если они добавлены до завершения forEach.

+ +

forEach исполняет функцию callback один раз для каждого элемента в объекте Map; не возвращает значение.

+ +

Примеры

+ +

Вывод содержимого объекта Map

+ +

Следующий код выводит в консоль строку для каждого элемента в объекте Map:

+ +
function logMapElements(value, key, map) {
+    console.log("m[" + key + "] = " + value);
+}
+new Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements);
+// logs:
+// "m[foo] = 3"
+// "m[bar] = [object Object]"
+// "m[baz] = undefined"
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
+ +

Совместимость с браузерами

+ +

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

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..8f91194549 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,69 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

Метод get() возвращает указанный элемент объекта {{jsxref("Map")}}.

+ +

Синтаксис

+ +
myMap.get(key);
+ +

Параметры

+ +
+
key
+
Обязательный. Ключ элемента объекта {{jsxref("Map")}}.
+
+ +

Возвращаемое значение

+ +

Возвращает элемент связанный с указанным ключом или undefined, если ключ не был найден в объекте {{jsxref("Map")}}​​​​.

+ +

Примеры

+ +

Использование метода get()

+ +
var myMap = new Map();
+myMap.set('bar', 'foo');
+
+myMap.get('bar');  // Вернёт "foo".
+myMap.get('baz');  // Вернёт undefined.
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}}
+ +

Поддержка браузерами

+ +

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

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..ce4cae29b7 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,72 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

Метод has() возвращает тип Boolean, указывающий существует ли элемент с указанным ключом или нет.

+ +

Синтаксис

+ +
myMap.has(key);
+ +

Параметры

+ +
+
key
+
Обязательный параметр. Ключ элемента для проверки существования в объекте Map.
+
+ +

Возвращаемое значение

+ +
+
Boolean
+
Возвращает true, если элемент с указанным ключом существует в объекте Map; в противном случае возвращает false.
+
+ +

Примеры

+ +

Использование метода has

+ +
var myMap = new Map();
+myMap.set('bar', "foo");
+
+myMap.has('bar');  // возвращает true
+myMap.has('baz');  // возвращает false
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Первоначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
+ +

Совместимость с браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..4ea24c2ad6 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,286 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +

Объект Map содержит пары ключ-значение и сохраняет порядок вставки. Любое значение (как объекты, так и {{Glossary("Primitive", "примитивы")}}) могут быть использованы в качестве ключей.

+ +

Синтаксис

+ +
new Map([iterable])
+ +

Параметры

+ +
+
iterable
+
Массив или любой другой итерируемый объект чьими элементами являются пары ключ-значение (массивы из двух элементов, например [[ 1, 'one' ],[ 2, 'two' ]]). Все пары ключ-значение будут добавлены в новый экземпляр Map; null расценивается как undefined.
+
+ +

Описание

+ +

Объект Map итерируется в порядке вставки его элементов — цикл {{jsxref("Statements/for...of", "for...of")}} будет возвращать массив [key, value] на каждой итерации.

+ +

Key equality

+ +

Сравнение ключей основано на алгоритме "{{Glossary("SameValueZero", "SameValueZero")}}": NaN равно NaN (несмотря на то, что NaN !== NaN), все другие значения рассматриваются равными исходя из семантики оператора строгого равенства ===. В текущей спецификации ECMAScript -0 и +0 принимаются равными, но в ранних версиях обсуждения это было не так (см. "Value equality for -0 and 0" в таблице совместимости с браузерами).

+ +

Сравнение Объектов и Map

+ +

Объекты похожи на Map в том, что оба позволяют устанавливать значения по ключам, получать эти значения, удалять ключи и проверять их наличие. В связи с этим (и потому, что не было встроенных альтернатив), {{jsxref("Object", "Объекты")}} исторически использовались как Map. Однако, у них есть ряд отличий, который даёт преимущества Map в ряде случаев:

+ + + +

Свойства

+ +
+
Map.length
+
Значение свойства length всегда равно 0.
+
Чтобы узнать количество элементов в Map - используйте {{jsxref("Map.prototype.size")}}.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
Функция-конструктор которая используется для создания производных объектов.
+
{{jsxref("Map.prototype")}}
+
Представляет прототип конструктора Map. Позволяет добавлять свойства всем объектам типа Map.
+
+ +

Экземпляры Map

+ +

Все экземпляры Map наследуются от {{jsxref("Map.prototype")}}.

+ +

Свойства

+ +
+
Map.prototype.constructor
+
Возвращает функцию, которая создала прототип экземпляра. Это функция Map по умолчанию.
+
Map.prototype.size
+
Возвращает количество пар ключ/значение в объекте Map.
+
+ +

Методы

+ +
+
Map.prototype.clear()
+
Удаляет все пары ключ / значение из объекта Map.
+
Map.prototype.delete(key)
+
Возвращает true, если элемент в объекте Map существовал и был удалён, или false, если элемент не существует. Map.prototype.has(key) вернёт false позже.
+
Map.prototype.entries()
+
Возвращает новый объект Iterator который содержит массив [key, value] для каждого элемента в объекте Map в порядке вставки.
+
Map.prototype.forEach(callbackFn[, thisArg])
+
Вызывает callbackFn один раз для каждой пары ключ-значение, присутствующей в объекте Map, в порядке вставки. Если для thisArg предоставляется параметр для forEach, он будет использоваться как значение this для каждого колбэка.
+
Map.prototype.get(key)
+
Возвращает значение связанное с key, или undefined если его нет.
+
Map.prototype.has(key)
+
Возвращает логическое значение, подтверждающее, было ли значение связано с key в объекте Map или нет.
+
Map.prototype.keys()
+
Возвращает новый объект Iterator содержащий ключи для каждого элемента в объекте Map в порядке вставки.
+
Map.prototype.set(key, value)
+
Устанавливает значение для key в объекте Map. Возвращает объект Map.
+
Map.prototype.values()
+
Возвращает новый объект Iterator который содержит значения для каждого элемента в объекте Map в порядке вставки.
+
Map.prototype[@@iterator]()
+
Возвращает новый объект Iterator который содержит массив [key, value] для каждого элемента в объекте Map в порядке вставки.
+
+ +

Примеры

+ +

Использование объекта Map

+ +
const myMap = new Map();
+
+const keyObj = {},
+    keyFunc = function () {},
+    keyString = 'a string';
+
+// задание значений
+myMap.set(keyString, 'value associated with “a string”');
+myMap.set(keyObj, 'value associated with keyObj');
+myMap.set(keyFunc, 'value associated with keyFunc');
+
+myMap.size; // 3
+
+// получение значений
+myMap.get(keyString);    // value associated with “a string”
+myMap.get(keyObj);       // value associated with keyObj
+myMap.get(keyFunc);      // value associated with keyFunc
+
+myMap.get('a string');   // "value associated with 'a string'"
+                         // потому что keyString === 'a string'
+myMap.get({});           // undefined, потому что keyObj !== {} ({} — это литеральная нотация конструктора класса Object)
+myMap.get(function() {}) // undefined, потому что keyFunc !== function () {}
+
+ +

Использование NaN в качестве ключей Map

+ +

NaN может быть использован в качестве ключа. Несмотря на то, что NaN не равен самому себе (NaN !== NaN вернёт true), следующий пример работает, потому что NaN обрабатывается особым образом:

+ +
const myMap = new Map();
+myMap.set(NaN, 'not a number');
+
+myMap.get(NaN); // not a number
+
+const otherNaN = Number('foo');
+myMap.get(otherNaN); // not a number
+
+ +

Итерация Map при помощи for..of

+ +

Map может быть итерирован с помощью for..of:

+ +
const myMap = new Map();
+myMap.set(0, 'zero');
+myMap.set(1, 'one');
+for (var [key, value] of myMap) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+for (var key of myMap.keys()) {
+  console.log(key);
+}
+// 0
+// 1
+
+for (var value of myMap.values()) {
+  console.log(value);
+}
+// zero
+// one
+
+for (var [key, value] of myMap.entries()) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+ +

Итерация Map при помощи forEach()

+ +

Map может быть итерирован с помощью метода forEach():

+ +
myMap.forEach(function(value, key) {
+  console.log(`${key} => ${value}`);
+});
+// 0 => zero
+// 1 => one
+
+ +

Взаимоотношения с объектом Array

+ +
const kvArray = [['key1', 'value1'], ['key2', 'value2']];
+
+// Используйте конструктор Map для преобразования двумерных массивов в Map
+const myMap = new Map(kvArray);
+
+myMap.get('key1'); // вернёт “value1”
+
+// Используйте функцию Array.from для трансформации Map в двумерный key-value массив
+console.log(Array.from(myMap)); // Выведет точно такой же массив как kvArray
+
+// Или используйте итераторы  keys или values чтобы преобразовать ключи или значения в массивы
+console.log(Array.from(myMap.keys())); // Выведет ['key1', 'key2']
+
+ +

Клонирование и слияние Map

+ +

 Равно как и {{jsxref("Array", "Массивы")}}, Map могут быть клонированы:

+ +
const original = new Map([
+  [1, 'one']
+]);
+
+const clone = new Map(original);
+
+console.log(clone.get(1)); // one
+console.log(original === clone); // false.
+ +

Следует помнить, что данные не клонируются.

+ +

Map могут быть слиты, с сохранением уникальности ключей:

+ +
const first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+const second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// Слияние двух Map. Взят будет последний повторившийся ключ.
+// Оператор Spread по сути преобразует Map в массив
+const merged = new Map([...first, ...second]);
+
+console.log(merged.get(1)); // uno
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+ +

Map могут быть слиты и с {{jsxref("Array", "Массивами")}}:

+ +
const first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+const second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// Слияние Map и массива. Как и при слиянии двух Map - взят будет последний повторившийся ключ.
+const merged = new Map([...first, ...second, [1, 'eins']]);
+
+console.log(merged.get(1)); // eins
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
+ +

Совместимость с браузерами

+

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

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..aeb0f7f568 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,66 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

Метод keys() возвращает новый Итератор, содержащий ключи каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.

+ +

Синтаксис

+ +
myMap.keys()
+ +

Возвращаемое значение

+ +

Новый итератор объекта {{jsxref("Map")}}.

+ +

Примеры

+ +

Использование метода keys()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
+ +

Поддержка браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..ae605adefd --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,89 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +
{{JSRef}}
+ +

Метод set() добавляет объекту {{jsxref("Map")}} новый элемент или обновляет существующий с указанными значениями key и value.

+ +

Синтаксис

+ +
myMap.set(key, value);
+ +

Параметры

+ +
+
key
+
Ключ добавляемого элемента.
+
value
+
Значение добавляемого элемента.
+
+ +

Возвращаемое значение

+ +

Объект {{jsxref("Map")}}.

+ +

Примеры

+ +

Использование метода set()

+ +
var myMap = new Map();
+
+// Добавление нового элемента объекту Map
+myMap.set('bar', 'foo');
+myMap.set(1, 'foobar');
+
+// Обновление существующего элемента
+myMap.set('bar', 'baz');
+
+ +

Последовательное использование метода set()

+ +

Так как метод set() возвращает объект Map, вы можете последовательно применять метод set() как в примере ниже:

+ +
// Последовательно добавляет новые элементы в myMap:
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}}
+ +

Поддержка браузерами

+ +

{{Compat}}

+ +

Примечание к поддержке браузерами

+ + + +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..243f05f282 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,65 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ +

Геттер size возвращает количество элементов в объекте {{jsxref("Map")}}.

+ +

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

+ +

Описание

+ +

Значение size - целое число, описывающее, сколько элементов имеет объект Map. У свойства size не определён сеттер: переопределить его нельзя.

+ +

Примеры

+ +

Использование size

+ +
var myMap = new Map();
+myMap.set("a", "альфа");
+myMap.set("b", "бета");
+myMap.set("g", "гамма");
+
+myMap.size // 3
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Первое определение
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}}
+ +

Совместимость с браузерами

+ +

{{Compat}}

+ +

Замечания для Gecko

+ + + +

Смотрите также

+ + diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..0cdf90c670 --- /dev/null +++ b/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,65 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
{{JSRef}}
+ +

Метод values() возвращает новый Итератор, содержащий значения каждого элемента в объекте {{jsxref("Map")}} в том порядке, в котором они были заведены.

+ +

Синтаксис

+ +
myMap.values()
+ +

Возвращаемое значение

+ +

Новый итератор объекта {{jsxref("Map")}}.

+ +

Примеры

+ +

Использование values()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

Поддержка браузерами

+ +

{{Compat}}

+ +

Смотрите также

+ + diff --git a/files/ru/web/api/node/getuserdata/index.html b/files/ru/web/api/node/getuserdata/index.html deleted file mode 100644 index 73882b5bec..0000000000 --- a/files/ru/web/api/node/getuserdata/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Node.getUserData() -slug: Web/API/Node/getUserData -translation_of: Web/API/Node/getUserData ---- -

{{APIRef("DOM")}}{{ obsolete_header() }}

- -

Метод Node.getUserData() возвращает любого пользователя {{domxref("DOMUserData")}} установленного предварительно на данном узле через {{domxref("Node.setUserData()")}}.

- -
-

Методы Node.setUserData и {{domxref("Node.getUserData")}} больше не доступны для веб-контента. {{domxref("Element.dataset")}} или WeakMap могут быть использованы вместо него.

-
- -

Синтаксис

- -
userData = someNode.getUserData(userKey);
- -

Параметры

- - - -

Пример

- -
var d = document.setUserData('key', 15, null);
-alert(document.getUserData('key')); // 15
- -

Спецификации

- - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Удалено из спецификации
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Изначальное описание
- -

Совместимость с браузерами

- -

{{Compat("api.Node.getUserData")}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/@@species/index.html b/files/ru/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index 5bda7a2fb3..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: 'get Map[@@species]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@species -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -
{{JSRef}}
- -

Акцессор свойства Map[@@species] возвращает Map конструктор.

- -

Синтаксис

- -
Map[Symbol.species]
-
- -

Описание

- -

Акцессор свойства species, возвращает конструктор по умолчанию для Map объектов. Конструкторы подклассов могут переопределить его, чтобы изменить поведение конструктора.

- -

Примеры

- -

Свойство species возвращает конструктор по умолчанию, который является конструктором Map для Map объектов:

- -
Map[Symbol.species]; // функция Map()
- -

В производном объекте коллекции (например, ваша пользовательская карта MyMap), MyMap species является MyMap конструктором. Однако, вы можете захотеть переопределить это, что бы вернуть родительский Map в методах вашего производного класса:

- -
class MyMap extends Map {
-  // Перезаписываем MyMap species на родительский Map конструктор
-  static get [Symbol.species]() { return Map; }
-}
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Исходное определение.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
- -

Поддержка браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/clear/index.html b/files/ru/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 487ba03b2a..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript6 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

Метод clear() удаляет все элементы из объекта Map.

- -

Синтаксис

- -
myMap.clear();
- -

Возвращаемое значение

- -

{{jsxref("undefined")}}.

- -

Примеры

- -

Использование метода clear

- -
var myMap = new Map();
-myMap.set('bar', 'baz');
-myMap.set(1, 'foo');
-
-myMap.size;       // 2
-myMap.has('bar'); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has('bar')  // false
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

Совместимость с браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/delete/index.html b/files/ru/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 6f3f12aeb4..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Ссылка - - метод - - прототип -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

Метод delete() удаляет указанный элемент из объекта {{jsxref("Map")}}.

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

Синтаксис

- -
myMap.delete(key);
- -

Параметры

- -
-
key
-
Ключ элемента удаляемого из объекта {{jsxref("Map")}}
-
- -

Возвращаемое значение

- -

true если элемент существовал в {{jsxref("Map")}} и он был удалён или false если элемента с таким ключом не было.

- -

Примеры

- -

Использование метода delete

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.delete("bar"); // Возвращает true. Успешно удалён.
-myMap.has("bar");    // Возвращает false. Элемента "bar" больше нет.
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES2015')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}}
- -

Совместимость с браузерами

-

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

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/entries/index.html b/files/ru/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index 18f1f9c417..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

Метод entries() возвращает новый Итератор, содержащий пары [key, value] для каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.

- -

Исходный код всех примеров для  {{jsxref("Map")}} сохранён на GitHub https://github.com/mdn/interactive-examples/tree/master/live-examples/js-examples/map.

- -

Вы можете внести свой вклад, для этого: 

- -

1. Клонируйте https://github.com/mdn/interactive-examples

- -

2. Ознакомьтесь с руководством https://github.com/mdn/interactive-examples/blob/master/CONTRIBUTING.md

- -

3. Напишите свой пример и отправьте нам запрос на извлечение.

- -

Синтаксис

- -
myMap.entries()
- -

Возвращаемое значение

- -

Новый итератор объекта {{jsxref("Map")}}.

- -

Примеры

- -

Использование entries()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}}
- -

Поддержка браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/foreach/index.html b/files/ru/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index 7ad360d46b..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

Метод forEach() выполняет переданную функцию единожды для каждой пары ключ/значение объекта Map в порядке их вставки.

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

Синтаксис

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

Параметры

- -
-
callback
-
Функция, которая будет выполнена для каждого элемента.
-
thisArg
-
Значение, которое будет использовано в качестве текущего при выполнении callback.
-
- -

Возвращаемое значение

- -

{{jsxref("undefined")}}.

- -

Описание

- -

Метод forEach выполняет переданный ему callback по разу для каждого фактически существующего ключа в наборе. Callback не вызывается для ключей, которые были удалены. Однако, он выполняется для элементов со значением undefined.

- -

При вызове callback используются три аргумента:

- - - -

Если аргумент thisArg указан для forEach, то при вызове callback он будет передан в качестве значения this.  В противном случае для this будет передано undefined. Значение this, в конечном итоге наблюдаемое в функции callback, определяется в соответствии c обычными правилами определения this в функции.

- -

Каждое значение посещается один раз, за исключением случая, когда оно было удалено и добавлено снова до завершения forEach. callback не вызывается для значений, удалённых до их посещения. Новые значения будут посещены, если они добавлены до завершения forEach.

- -

forEach исполняет функцию callback один раз для каждого элемента в объекте Map; не возвращает значение.

- -

Примеры

- -

Вывод содержимого объекта Map

- -

Следующий код выводит в консоль строку для каждого элемента в объекте Map:

- -
function logMapElements(value, key, map) {
-    console.log("m[" + key + "] = " + value);
-}
-new Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements);
-// logs:
-// "m[foo] = 3"
-// "m[bar] = [object Object]"
-// "m[baz] = undefined"
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}{{Spec2('ESDraft')}} 
- -

Совместимость с браузерами

- -

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

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/get/index.html b/files/ru/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 68da178b4e..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

Метод get() возвращает указанный элемент объекта {{jsxref("Map")}}.

- -

Синтаксис

- -
myMap.get(key);
- -

Параметры

- -
-
key
-
Обязательный. Ключ элемента объекта {{jsxref("Map")}}.
-
- -

Возвращаемое значение

- -

Возвращает элемент связанный с указанным ключом или undefined, если ключ не был найден в объекте {{jsxref("Map")}}​​​​.

- -

Примеры

- -

Использование метода get()

- -
var myMap = new Map();
-myMap.set('bar', 'foo');
-
-myMap.get('bar');  // Вернёт "foo".
-myMap.get('baz');  // Вернёт undefined.
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}}
- -

Поддержка браузерами

- -

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

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/has/index.html b/files/ru/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 21afda8813..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

Метод has() возвращает тип Boolean, указывающий существует ли элемент с указанным ключом или нет.

- -

Синтаксис

- -
myMap.has(key);
- -

Параметры

- -
-
key
-
Обязательный параметр. Ключ элемента для проверки существования в объекте Map.
-
- -

Возвращаемое значение

- -
-
Boolean
-
Возвращает true, если элемент с указанным ключом существует в объекте Map; в противном случае возвращает false.
-
- -

Примеры

- -

Использование метода has

- -
var myMap = new Map();
-myMap.set('bar', "foo");
-
-myMap.has('bar');  // возвращает true
-myMap.has('baz');  // возвращает false
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES2015')}}Первоначальное определение.
{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ESDraft')}} 
- -

Совместимость с браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/index.html b/files/ru/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 6a48476869..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,285 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -

Объект Map содержит пары ключ-значение и сохраняет порядок вставки. Любое значение (как объекты, так и {{Glossary("Primitive", "примитивы")}}) могут быть использованы в качестве ключей.

- -

Синтаксис

- -
new Map([iterable])
- -

Параметры

- -
-
iterable
-
Массив или любой другой итерируемый объект чьими элементами являются пары ключ-значение (массивы из двух элементов, например [[ 1, 'one' ],[ 2, 'two' ]]). Все пары ключ-значение будут добавлены в новый экземпляр Map; null расценивается как undefined.
-
- -

Описание

- -

Объект Map итерируется в порядке вставки его элементов — цикл {{jsxref("Statements/for...of", "for...of")}} будет возвращать массив [key, value] на каждой итерации.

- -

Key equality

- -

Сравнение ключей основано на алгоритме "{{Glossary("SameValueZero", "SameValueZero")}}": NaN равно NaN (несмотря на то, что NaN !== NaN), все другие значения рассматриваются равными исходя из семантики оператора строгого равенства ===. В текущей спецификации ECMAScript -0 и +0 принимаются равными, но в ранних версиях обсуждения это было не так (см. "Value equality for -0 and 0" в таблице совместимости с браузерами).

- -

Сравнение Объектов и Map

- -

Объекты похожи на Map в том, что оба позволяют устанавливать значения по ключам, получать эти значения, удалять ключи и проверять их наличие. В связи с этим (и потому, что не было встроенных альтернатив), {{jsxref("Object", "Объекты")}} исторически использовались как Map. Однако, у них есть ряд отличий, который даёт преимущества Map в ряде случаев:

- - - -

Свойства

- -
-
Map.length
-
Значение свойства length всегда равно 0.
-
Чтобы узнать количество элементов в Map - используйте {{jsxref("Map.prototype.size")}}.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
Функция-конструктор которая используется для создания производных объектов.
-
{{jsxref("Map.prototype")}}
-
Представляет прототип конструктора Map. Позволяет добавлять свойства всем объектам типа Map.
-
- -

Экземпляры Map

- -

Все экземпляры Map наследуются от {{jsxref("Map.prototype")}}.

- -

Свойства

- -
-
Map.prototype.constructor
-
Возвращает функцию, которая создала прототип экземпляра. Это функция Map по умолчанию.
-
Map.prototype.size
-
Возвращает количество пар ключ/значение в объекте Map.
-
- -

Методы

- -
-
Map.prototype.clear()
-
Удаляет все пары ключ / значение из объекта Map.
-
Map.prototype.delete(key)
-
Возвращает true, если элемент в объекте Map существовал и был удалён, или false, если элемент не существует. Map.prototype.has(key) вернёт false позже.
-
Map.prototype.entries()
-
Возвращает новый объект Iterator который содержит массив [key, value] для каждого элемента в объекте Map в порядке вставки.
-
Map.prototype.forEach(callbackFn[, thisArg])
-
Вызывает callbackFn один раз для каждой пары ключ-значение, присутствующей в объекте Map, в порядке вставки. Если для thisArg предоставляется параметр для forEach, он будет использоваться как значение this для каждого колбэка.
-
Map.prototype.get(key)
-
Возвращает значение связанное с key, или undefined если его нет.
-
Map.prototype.has(key)
-
Возвращает логическое значение, подтверждающее, было ли значение связано с key в объекте Map или нет.
-
Map.prototype.keys()
-
Возвращает новый объект Iterator содержащий ключи для каждого элемента в объекте Map в порядке вставки.
-
Map.prototype.set(key, value)
-
Устанавливает значение для key в объекте Map. Возвращает объект Map.
-
Map.prototype.values()
-
Возвращает новый объект Iterator который содержит значения для каждого элемента в объекте Map в порядке вставки.
-
Map.prototype[@@iterator]()
-
Возвращает новый объект Iterator который содержит массив [key, value] для каждого элемента в объекте Map в порядке вставки.
-
- -

Примеры

- -

Использование объекта Map

- -
const myMap = new Map();
-
-const keyObj = {},
-    keyFunc = function () {},
-    keyString = 'a string';
-
-// задание значений
-myMap.set(keyString, 'value associated with “a string”');
-myMap.set(keyObj, 'value associated with keyObj');
-myMap.set(keyFunc, 'value associated with keyFunc');
-
-myMap.size; // 3
-
-// получение значений
-myMap.get(keyString);    // value associated with “a string”
-myMap.get(keyObj);       // value associated with keyObj
-myMap.get(keyFunc);      // value associated with keyFunc
-
-myMap.get('a string');   // "value associated with 'a string'"
-                         // потому что keyString === 'a string'
-myMap.get({});           // undefined, потому что keyObj !== {} ({} — это литеральная нотация конструктора класса Object)
-myMap.get(function() {}) // undefined, потому что keyFunc !== function () {}
-
- -

Использование NaN в качестве ключей Map

- -

NaN может быть использован в качестве ключа. Несмотря на то, что NaN не равен самому себе (NaN !== NaN вернёт true), следующий пример работает, потому что NaN обрабатывается особым образом:

- -
const myMap = new Map();
-myMap.set(NaN, 'not a number');
-
-myMap.get(NaN); // not a number
-
-const otherNaN = Number('foo');
-myMap.get(otherNaN); // not a number
-
- -

Итерация Map при помощи for..of

- -

Map может быть итерирован с помощью for..of:

- -
const myMap = new Map();
-myMap.set(0, 'zero');
-myMap.set(1, 'one');
-for (var [key, value] of myMap) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
-for (var key of myMap.keys()) {
-  console.log(key);
-}
-// 0
-// 1
-
-for (var value of myMap.values()) {
-  console.log(value);
-}
-// zero
-// one
-
-for (var [key, value] of myMap.entries()) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
- -

Итерация Map при помощи forEach()

- -

Map может быть итерирован с помощью метода forEach():

- -
myMap.forEach(function(value, key) {
-  console.log(`${key} => ${value}`);
-});
-// 0 => zero
-// 1 => one
-
- -

Взаимоотношения с объектом Array

- -
const kvArray = [['key1', 'value1'], ['key2', 'value2']];
-
-// Используйте конструктор Map для преобразования двумерных массивов в Map
-const myMap = new Map(kvArray);
-
-myMap.get('key1'); // вернёт “value1”
-
-// Используйте функцию Array.from для трансформации Map в двумерный key-value массив
-console.log(Array.from(myMap)); // Выведет точно такой же массив как kvArray
-
-// Или используйте итераторы  keys или values чтобы преобразовать ключи или значения в массивы
-console.log(Array.from(myMap.keys())); // Выведет ['key1', 'key2']
-
- -

Клонирование и слияние Map

- -

 Равно как и {{jsxref("Array", "Массивы")}}, Map могут быть клонированы:

- -
const original = new Map([
-  [1, 'one']
-]);
-
-const clone = new Map(original);
-
-console.log(clone.get(1)); // one
-console.log(original === clone); // false.
- -

Следует помнить, что данные не клонируются.

- -

Map могут быть слиты, с сохранением уникальности ключей:

- -
const first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-const second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// Слияние двух Map. Взят будет последний повторившийся ключ.
-// Оператор Spread по сути преобразует Map в массив
-const merged = new Map([...first, ...second]);
-
-console.log(merged.get(1)); // uno
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
- -

Map могут быть слиты и с {{jsxref("Array", "Массивами")}}:

- -
const first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-const second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// Слияние Map и массива. Как и при слиянии двух Map - взят будет последний повторившийся ключ.
-const merged = new Map([...first, ...second, [1, 'eins']]);
-
-console.log(merged.get(1)); // eins
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

Совместимость с браузерами

-

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

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/keys/index.html b/files/ru/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index 788440c5e7..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{JSRef}}
- -

Метод keys() возвращает новый Итератор, содержащий ключи каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.

- -

Синтаксис

- -
myMap.keys()
- -

Возвращаемое значение

- -

Новый итератор объекта {{jsxref("Map")}}.

- -

Примеры

- -

Использование метода keys()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}} 
- -

Поддержка браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/set/index.html b/files/ru/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 4e3fa249c3..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -
{{JSRef}}
- -

Метод set() добавляет объекту {{jsxref("Map")}} новый элемент или обновляет существующий с указанными значениями key и value.

- -

Синтаксис

- -
myMap.set(key, value);
- -

Параметры

- -
-
key
-
Ключ добавляемого элемента.
-
value
-
Значение добавляемого элемента.
-
- -

Возвращаемое значение

- -

Объект {{jsxref("Map")}}.

- -

Примеры

- -

Использование метода set()

- -
var myMap = new Map();
-
-// Добавление нового элемента объекту Map
-myMap.set('bar', 'foo');
-myMap.set(1, 'foobar');
-
-// Обновление существующего элемента
-myMap.set('bar', 'baz');
-
- -

Последовательное использование метода set()

- -

Так как метод set() возвращает объект Map, вы можете последовательно применять метод set() как в примере ниже:

- -
// Последовательно добавляет новые элементы в myMap:
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}}
- -

Поддержка браузерами

- -

{{Compat}}

- -

Примечание к поддержке браузерами

- - - -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/size/index.html b/files/ru/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 0b88808058..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- -

Геттер size возвращает количество элементов в объекте {{jsxref("Map")}}.

- -

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

- -

Описание

- -

Значение size - целое число, описывающее, сколько элементов имеет объект Map. У свойства size не определён сеттер: переопределить его нельзя.

- -

Примеры

- -

Использование size

- -
var myMap = new Map();
-myMap.set("a", "альфа");
-myMap.set("b", "бета");
-myMap.set("g", "гамма");
-
-myMap.size // 3
-
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES2015')}}Первое определение
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}}
- -

Совместимость с браузерами

- -

{{Compat}}

- -

Замечания для Gecko

- - - -

Смотрите также

- - diff --git a/files/ru/web/javascript/reference/global_objects/map/values/index.html b/files/ru/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index ae1e78615e..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
{{JSRef}}
- -

Метод values() возвращает новый Итератор, содержащий значения каждого элемента в объекте {{jsxref("Map")}} в том порядке, в котором они были заведены.

- -

Синтаксис

- -
myMap.values()
- -

Возвращаемое значение

- -

Новый итератор объекта {{jsxref("Map")}}.

- -

Примеры

- -

Использование values()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

Спецификации

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

Поддержка браузерами

- -

{{Compat}}

- -

Смотрите также

- - diff --git a/files/zh-cn/_redirects.txt b/files/zh-cn/_redirects.txt index 574ba4e338..a6d351e192 100644 --- a/files/zh-cn/_redirects.txt +++ b/files/zh-cn/_redirects.txt @@ -844,7 +844,7 @@ /zh-CN/docs/JS-ref/Global_Objects/null /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/null /zh-CN/docs/JS-ref/Global_Objects/parseFloat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/parseFloat /zh-CN/docs/JS-ref/Global_Objects/undefined /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/undefined -/zh-CN/docs/JS-ref/Map /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/JS-ref/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/JS-ref/Operators /zh-CN/docs/Web/JavaScript/Reference/Operators /zh-CN/docs/JS-ref/Operators/Logical_Operators /zh-CN/docs/conflicting/Web/JavaScript/Reference/Operators_f71733c8e7001a29c3ec40d8522a4aca /zh-CN/docs/JS-ref/Operators/Operator_Precedence /zh-CN/docs/Web/JavaScript/Reference/Operators/Operator_Precedence @@ -1023,7 +1023,7 @@ /zh-CN/docs/JavaScript/Reference/Global_Objects/Function/toString /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/toString /zh-CN/docs/JavaScript/Reference/Global_Objects/JSON /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/JSON /zh-CN/docs/JavaScript/Reference/Global_Objects/JSON/stringify /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify -/zh-CN/docs/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/JavaScript/Reference/Global_Objects/Math /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math /zh-CN/docs/JavaScript/Reference/Global_Objects/Math/SQRT2 /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/SQRT2 /zh-CN/docs/JavaScript/Reference/Global_Objects/Math/abs /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/abs @@ -1127,7 +1127,7 @@ /zh-CN/docs/JavaScript/Reference/Global_Objects/null /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/null /zh-CN/docs/JavaScript/Reference/Global_Objects/parseFloat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/parseFloat /zh-CN/docs/JavaScript/Reference/Global_Objects/undefined /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/undefined -/zh-CN/docs/JavaScript/Reference/Map /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/JavaScript/Reference/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/JavaScript/Reference/Operators /zh-CN/docs/Web/JavaScript/Reference/Operators /zh-CN/docs/JavaScript/Reference/Operators/Logical_Operators /zh-CN/docs/conflicting/Web/JavaScript/Reference/Operators_f71733c8e7001a29c3ec40d8522a4aca /zh-CN/docs/JavaScript/Reference/Operators/Operator_Precedence /zh-CN/docs/Web/JavaScript/Reference/Operators/Operator_Precedence @@ -1686,7 +1686,7 @@ /zh-CN/docs/Web/API/Node.compareDocumentPosition /zh-CN/docs/Web/API/Node/compareDocumentPosition /zh-CN/docs/Web/API/Node.contains /zh-CN/docs/Web/API/Node/contains /zh-CN/docs/Web/API/Node.firstChild /zh-CN/docs/Web/API/Node/firstChild -/zh-CN/docs/Web/API/Node.getUserData /zh-CN/docs/Web/API/Node/getUserData +/zh-CN/docs/Web/API/Node.getUserData /zh-CN/docs/orphaned/Web/API/Node/getUserData /zh-CN/docs/Web/API/Node.hasAttributes /zh-CN/docs/Web/API/Element/hasAttributes /zh-CN/docs/Web/API/Node.hasChildNodes /zh-CN/docs/Web/API/Node/hasChildNodes /zh-CN/docs/Web/API/Node.insertBefore /zh-CN/docs/Web/API/Node/insertBefore @@ -1712,11 +1712,12 @@ /zh-CN/docs/Web/API/Node.previousSibling /zh-CN/docs/Web/API/Node/previousSibling /zh-CN/docs/Web/API/Node.removeChild /zh-CN/docs/Web/API/Node/removeChild /zh-CN/docs/Web/API/Node.replaceChild /zh-CN/docs/Web/API/Node/replaceChild -/zh-CN/docs/Web/API/Node.setUserData /zh-CN/docs/Web/API/Node/setUserData +/zh-CN/docs/Web/API/Node.setUserData /zh-CN/docs/orphaned/Web/API/Node/setUserData /zh-CN/docs/Web/API/Node.textContent /zh-CN/docs/Web/API/Node/textContent /zh-CN/docs/Web/API/Node/C /zh-CN/docs/Web/API/Node/contains /zh-CN/docs/Web/API/Node/baseURIObject /zh-CN/docs/conflicting/Web/API/Node /zh-CN/docs/Web/API/Node/childNodes_temp /zh-CN/docs/Web/API/Node/childNodes +/zh-CN/docs/Web/API/Node/getUserData /zh-CN/docs/orphaned/Web/API/Node/getUserData /zh-CN/docs/Web/API/Node/hasAttributes /zh-CN/docs/Web/API/Element/hasAttributes /zh-CN/docs/Web/API/Node/innerText /zh-CN/docs/Web/API/HTMLElement/innerText /zh-CN/docs/Web/API/Node/localName /zh-CN/docs/conflicting/Web/API/Element/localName @@ -1725,6 +1726,7 @@ /zh-CN/docs/Web/API/Node/outerText /zh-CN/docs/conflicting/Web/API/HTMLElement/outerText /zh-CN/docs/Web/API/Node/prefix /zh-CN/docs/conflicting/Web/API/Element/prefix /zh-CN/docs/Web/API/Node/rootNode /zh-CN/docs/conflicting/Web/API/Node/getRootNode +/zh-CN/docs/Web/API/Node/setUserData /zh-CN/docs/orphaned/Web/API/Node/setUserData /zh-CN/docs/Web/API/NodeList.item /zh-CN/docs/Web/API/NodeList/item /zh-CN/docs/Web/API/NonDocumentTypeChildNode /zh-CN/docs/conflicting/Web/API/Element_861159909c20acebf8e506c3bb0e2f7e /zh-CN/docs/Web/API/NonDocumentTypeChildNode.nextElementSibling /zh-CN/docs/Web/API/Element/nextElementSibling @@ -2527,7 +2529,22 @@ /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype /zh-CN/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/ListFormat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Locale /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/get /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/has /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /zh-CN/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/set /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/size /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map/values /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/反双曲余弦值 /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math/acosh /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /zh-CN/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat @@ -2592,7 +2609,7 @@ /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype /zh-CN/docs/conflicting/Web/JavaScript/Reference/Global_Objects/WeakSet /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/生成器函数 /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/GeneratorFunction /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/生成器函数/prototype /zh-CN/docs/conflicting/Web/JavaScript/Reference/Global_Objects/GeneratorFunction -/zh-CN/docs/Web/JavaScript/Reference/Map /zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map +/zh-CN/docs/Web/JavaScript/Reference/Map /zh-CN/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map /zh-CN/docs/Web/JavaScript/Reference/Methods_Index /zh-CN/docs/Web/JavaScript/Reference /zh-CN/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators /zh-CN/docs/conflicting/Web/JavaScript/Reference/Operators /zh-CN/docs/Web/JavaScript/Reference/Operators/Assignment_Operators /zh-CN/docs/conflicting/Web/JavaScript/Reference/Operators_8d54701de06af40a7c984517cbe87b3e diff --git a/files/zh-cn/_wikihistory.json b/files/zh-cn/_wikihistory.json index cf9af29efc..df636cf7db 100644 --- a/files/zh-cn/_wikihistory.json +++ b/files/zh-cn/_wikihistory.json @@ -18255,13 +18255,6 @@ "xuetengfei" ] }, - "Web/API/Node/getUserData": { - "modified": "2019-03-23T23:09:37.543Z", - "contributors": [ - "teoli", - "AlexChao" - ] - }, "Web/API/Node/hasChildNodes": { "modified": "2019-03-24T00:16:18.421Z", "contributors": [ @@ -18471,13 +18464,6 @@ "ziyunfei" ] }, - "Web/API/Node/setUserData": { - "modified": "2019-03-23T23:09:32.465Z", - "contributors": [ - "teoli", - "AlexChao" - ] - }, "Web/API/Node/textContent": { "modified": "2020-10-15T21:24:14.842Z", "contributors": [ @@ -39960,152 +39946,6 @@ "Lovesueee" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:06:49.701Z", - "contributors": [ - "laampui", - "wallena3", - "KaySama", - "Turner", - "YaoZeyuan", - "Mr_Big", - "maoyumaoxun", - "hong007", - "zhangchen", - "Amio", - "tsejx", - "thegatheringstorm", - "buckarooch", - "xgqfrms-GitHub", - "kameii", - "Cattla", - "huguangju", - "YangyuhaoBit", - "luneice", - "git123hub", - "Ende93", - "sqqihao", - "fskuok", - "teoli", - "ziyunfei", - "zhangyaochun1987" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { - "modified": "2020-10-15T21:56:27.573Z", - "contributors": [ - "Ende93", - "DuLinRain" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@species": { - "modified": "2020-10-15T21:57:35.566Z", - "contributors": [ - "vanishcode" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { - "modified": "2019-04-05T14:04:42.613Z", - "contributors": [ - "DuLinRain" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/Map": { - "modified": "2020-10-15T22:29:02.199Z", - "contributors": [ - "laampui" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/clear": { - "modified": "2020-10-15T21:41:32.043Z", - "contributors": [ - "zhangchen", - "SphinxKnight", - "HsuanLee", - "youth7" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/delete": { - "modified": "2020-10-15T21:46:05.144Z", - "contributors": [ - "zhangchen", - "royl8", - "Hushabyme", - "webery" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/entries": { - "modified": "2020-10-15T21:39:28.129Z", - "contributors": [ - "Louis-7", - "SphinxKnight", - "ngtmuzi", - "HsuanLee", - "Zhiyu_Wang" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/forEach": { - "modified": "2020-10-15T21:39:26.824Z", - "contributors": [ - "Mr_kaze", - "niices", - "liu7654", - "SimonYang", - "SphinxKnight", - "ziyunfei", - "Zhiyu_Wang" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/get": { - "modified": "2020-10-15T21:39:27.794Z", - "contributors": [ - "RainSlide", - "SphinxKnight", - "ziyunfei", - "Zhiyu_Wang" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/has": { - "modified": "2019-10-04T10:03:31.075Z", - "contributors": [ - "Cyberhan123", - "SphinxKnight", - "DirtyPP" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/keys": { - "modified": "2020-10-15T21:48:38.432Z", - "contributors": [ - "Davidyanlong", - "RainSlide", - "zachary05" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/set": { - "modified": "2020-10-15T21:48:37.587Z", - "contributors": [ - "CascEco", - "ts0307", - "RainSlide", - "MaZheng", - "Hushabyme", - "zachary05" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/size": { - "modified": "2019-09-06T04:35:48.843Z", - "contributors": [ - "boyue", - "wenshin" - ] - }, - "Web/JavaScript/Reference/Global_Objects/Map/values": { - "modified": "2019-10-04T09:57:38.527Z", - "contributors": [ - "killsos", - "mingzhaov" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:21:09.889Z", "contributors": [ @@ -50148,6 +49988,20 @@ "ChenChenJoke" ] }, + "orphaned/Web/API/Node/getUserData": { + "modified": "2019-03-23T23:09:37.543Z", + "contributors": [ + "teoli", + "AlexChao" + ] + }, + "orphaned/Web/API/Node/setUserData": { + "modified": "2019-03-23T23:09:32.465Z", + "contributors": [ + "teoli", + "AlexChao" + ] + }, "orphaned/Web/API/Notation": { "modified": "2020-10-15T22:20:06.303Z", "contributors": [ @@ -50645,6 +50499,152 @@ "lxuewu" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:06:49.701Z", + "contributors": [ + "laampui", + "wallena3", + "KaySama", + "Turner", + "YaoZeyuan", + "Mr_Big", + "maoyumaoxun", + "hong007", + "zhangchen", + "Amio", + "tsejx", + "thegatheringstorm", + "buckarooch", + "xgqfrms-GitHub", + "kameii", + "Cattla", + "huguangju", + "YangyuhaoBit", + "luneice", + "git123hub", + "Ende93", + "sqqihao", + "fskuok", + "teoli", + "ziyunfei", + "zhangyaochun1987" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator": { + "modified": "2020-10-15T21:56:27.573Z", + "contributors": [ + "Ende93", + "DuLinRain" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species": { + "modified": "2020-10-15T21:57:35.566Z", + "contributors": [ + "vanishcode" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag": { + "modified": "2019-04-05T14:04:42.613Z", + "contributors": [ + "DuLinRain" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map": { + "modified": "2020-10-15T22:29:02.199Z", + "contributors": [ + "laampui" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear": { + "modified": "2020-10-15T21:41:32.043Z", + "contributors": [ + "zhangchen", + "SphinxKnight", + "HsuanLee", + "youth7" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete": { + "modified": "2020-10-15T21:46:05.144Z", + "contributors": [ + "zhangchen", + "royl8", + "Hushabyme", + "webery" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries": { + "modified": "2020-10-15T21:39:28.129Z", + "contributors": [ + "Louis-7", + "SphinxKnight", + "ngtmuzi", + "HsuanLee", + "Zhiyu_Wang" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach": { + "modified": "2020-10-15T21:39:26.824Z", + "contributors": [ + "Mr_kaze", + "niices", + "liu7654", + "SimonYang", + "SphinxKnight", + "ziyunfei", + "Zhiyu_Wang" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/get": { + "modified": "2020-10-15T21:39:27.794Z", + "contributors": [ + "RainSlide", + "SphinxKnight", + "ziyunfei", + "Zhiyu_Wang" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/has": { + "modified": "2019-10-04T10:03:31.075Z", + "contributors": [ + "Cyberhan123", + "SphinxKnight", + "DirtyPP" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys": { + "modified": "2020-10-15T21:48:38.432Z", + "contributors": [ + "Davidyanlong", + "RainSlide", + "zachary05" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/set": { + "modified": "2020-10-15T21:48:37.587Z", + "contributors": [ + "CascEco", + "ts0307", + "RainSlide", + "MaZheng", + "Hushabyme", + "zachary05" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/size": { + "modified": "2019-09-06T04:35:48.843Z", + "contributors": [ + "boyue", + "wenshin" + ] + }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map/values": { + "modified": "2019-10-04T09:57:38.527Z", + "contributors": [ + "killsos", + "mingzhaov" + ] + }, "orphaned/Web/JavaScript/Reference/Global_Objects/WeakSet/clear": { "modified": "2019-03-23T22:18:46.466Z", "contributors": [ diff --git a/files/zh-cn/orphaned/web/api/node/getuserdata/index.html b/files/zh-cn/orphaned/web/api/node/getuserdata/index.html new file mode 100644 index 0000000000..74dbaf067e --- /dev/null +++ b/files/zh-cn/orphaned/web/api/node/getuserdata/index.html @@ -0,0 +1,97 @@ +--- +title: Node.getUserData() +slug: orphaned/Web/API/Node/getUserData +translation_of: Web/API/Node/getUserData +original_slug: Web/API/Node/getUserData +--- +

{{ APIRef }}{{ obsolete_header() }}

+

The Node.getUserData() method returns any user {{domxref("DOMUserData")}} set previously on the given node by {{domxref("Node.setUserData()")}}.

+
+

The Node.setUserData and {{domxref("Node.getUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

+
+

Syntax

+
userData = someNode.getUserData(userKey);
+

Parameters

+ +

Example

+
var d = document.setUserData('key', 15, null);
+alert(document.getUserData('key')); // 15
+

Specifications

+ + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Initial definition.
+

Browser compatibility

+

{{CompatibilityTable}}

+
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}Supported from {{CompatGeckoDesktop("1.0")}} to {{CompatGeckoDesktop("21.0")}}.
+ Removed in {{CompatGeckoDesktop("22.0")}} [1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
+
+
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}Supported from {{CompatGeckoMobile("1.0")}} to {{CompatGeckoMobile("21.0")}}.
+ Removed in {{CompatGeckoMobile("22.0")}} [1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
+
+

[1] The method is still available from chrome scripts.

+

See also

+ diff --git a/files/zh-cn/orphaned/web/api/node/setuserdata/index.html b/files/zh-cn/orphaned/web/api/node/setuserdata/index.html new file mode 100644 index 0000000000..361bfcca25 --- /dev/null +++ b/files/zh-cn/orphaned/web/api/node/setuserdata/index.html @@ -0,0 +1,104 @@ +--- +title: Node.setUserData() +slug: orphaned/Web/API/Node/setUserData +translation_of: Web/API/Node/setUserData +original_slug: Web/API/Node/setUserData +--- +

{{ APIRef }}{{ obsolete_header() }}

+

The Node.setUserData() method allows a user to attach (or remove) data to an element, without needing to modify the DOM. Note that such data will not be preserved when imported via {{domxref("Node.importNode")}}, as with {{domxref("Node.cloneNode()")}} and {{domxref("Node.renameNode()")}} operations (though {{domxref("Node.adoptNode")}} does preserve the information), and equality tests in {{domxref("Node.isEqualNode()")}} do not consider user data in making the assessment.

+

This method offers the convenience of associating data with specific nodes without needing to alter the structure of a document and in a standard fashion, but it also means that extra steps may need to be taken if one wishes to serialize the information or include the information upon clone, import, or rename operations.

+
+

The Node.getUserData and {{domxref("Node.setUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

+
+

Syntax

+
prevUserData = someNode.setUserData(userKey, userData, handler);
+

Parameters

+ +

Example

+
var d = document.implementation.createDocument('', 'test', null);
+d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {alert(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
+alert(d.documentElement.getUserData('key')); // 15
+var e = document.importNode(d.documentElement, true); // causes handler to be called
+alert(e.getUserData('key')); // null since user data is not copied
+
+

Specifications

+ + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Initial definition.
+

Browser compatibility

+

{{CompatibilityTable}}

+
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}Supported from {{CompatGeckoDesktop("1.0")}} to {{CompatGeckoDesktop("21.0")}}.
+ Removed in {{CompatGeckoDesktop("22.0")}} [1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
+
+
+ + + + + + + + + + + + + + + + + + + +
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}Supported from {{CompatGeckoMobile("1.0")}} to {{CompatGeckoMobile("21.0")}}.
+ Removed in {{CompatGeckoMobile("22.0")}} [1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
+
+

[1] The method is still available from chrome scripts.

+

See also

+ diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html new file mode 100644 index 0000000000..9a93339548 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@iterator/index.html @@ -0,0 +1,102 @@ +--- +title: Map.prototype[@@iterator]() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@iterator +tags: + - ECMAScript 2015 + - Iterator + - JavaScript + - Map + - Method + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator +--- +
{{JSRef}}
+ +

@@iterator 属性的初始值与 {{jsxref("Map.prototype.entries()", "entries")}} 属性的初始值是同一个函数对象。

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

语法

+ +
myMap[Symbol.iterator]
+ +

返回值

+ +

map 的 iterator 函数默认就是 {{jsxref("Map.prototype.entries()", "entries()")}} 函数。

+ +

示例

+ +

使用 [@@iterator]()

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+var mapIter = myMap[Symbol.iterator]();
+//返回的其实是个generator
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

在for..of中使用[@@iterator]() 

+ +
var myMap = new Map();
+myMap.set('0', 'foo');
+myMap.set(1, 'bar');
+myMap.set({}, 'baz');
+
+for (const entry of myMap) {
+  console.log(entry);
+}
+// ["0", "foo"]
+// [1, "bar"]
+// [{}, "baz"]
+
+for (var v of myMap) {
+  console.log(v);
+}
+
+// 0: foo
+// 1: bar
+// [Object]: baz
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容

+ + + +

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

+ +

另见

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@species/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@species/index.html new file mode 100644 index 0000000000..c451e94285 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@species/index.html @@ -0,0 +1,68 @@ +--- +title: get Map[@@species] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species +--- +
{{JSRef}}
+ +

 Map[@@species] 访问器属性会返回一个 Map 构造函数.

+ +

语法

+ +
Map[Symbol.species]
+
+ +

描述

+ +

The species accessor property returns the default constructor for Map objects. Subclass constructors may over-ride it to change the constructor assignment.

+ +

案例

+ +

The species property returns the default constructor function, which is the Map constructor for Map objects:

+ +
Map[Symbol.species]; // function Map()
+ +

In a derived collection object (e.g. your custom map MyMap), the MyMap species is the MyMap constructor. However, you might want to overwrite this, in order to return parent Map objects in your derived class methods:

+ +
class MyMap extends Map {
+  // 重写覆盖 MyMap species to the parent Map constructor
+  static get [Symbol.species]() { return Map; }
+}
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容性

+ +
+ + +

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

+
+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html new file mode 100644 index 0000000000..f592aedbf4 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/@@tostringtag/index.html @@ -0,0 +1,96 @@ +--- +title: Map.prototype[@@toStringTag] +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag +--- +
{{JSRef}}
+ +

 Map[@@toStringTag] 的初始值是"Map".

+ +
{{js_property_attributes(0,0,1)}}
+ +

语法

+ +
Map[Symbol.toStringTag]
+ +

示例

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

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容

+ +

{{CompatibilityTable}} 

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatChrome(44.0) }}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatNo }}{{ CompatChrome(44.0) }}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatChrome(44.0)}}
+
diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/clear/index.html new file mode 100644 index 0000000000..b23ce95ce2 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/clear/index.html @@ -0,0 +1,77 @@ +--- +title: Map.prototype.clear() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear +tags: + - ECMAScript 2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear +original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear +--- +
{{JSRef}}
+ +

clear()方法会移除Map对象中的所有元素。

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

语法

+ +
myMap.clear();
+
+ +

返回值

+ +

{{jsxref("undefined")}}.

+ +

示例

+ +

调用clear方法

+ +
var myMap = new Map();
+myMap.set("bar", "baz");
+myMap.set(1, "foo");
+
+myMap.size;       // 2
+myMap.has("bar"); // true
+
+myMap.clear();
+
+myMap.size;       // 0
+myMap.has("bar")  // false
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容

+ + + +

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

+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/delete/index.html new file mode 100644 index 0000000000..6cac469211 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/delete/index.html @@ -0,0 +1,84 @@ +--- +title: Map.prototype.delete() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype +translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete +original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete +--- +
{{JSRef}}
+ +

 delete() 方法用于移除 Map 对象中指定的元素。

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

语法

+ +
myMap.delete(key);
+ +

参数

+ +
+
key
+
必须。从 Map 对象中移除的元素的键。
+
+ +

返回值

+ +
+
Boolean
+
如果 Map 对象中存在该元素，则移除它并返回 true；否则如果该元素不存在则返回 false。
+
+ +

示例

+ +

使用 delete 方法

+ +
var myMap = new Map();
+myMap.set("bar", "foo");
+
+myMap.delete("bar"); // 返回 true。成功地移除元素
+myMap.has("bar");    // 返回 false。"bar" 元素将不再存在于 Map 实例中
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容性

+ + + +

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

+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/entries/index.html new file mode 100644 index 0000000000..578ddb51ee --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/entries/index.html @@ -0,0 +1,73 @@ +--- +title: Map.prototype.entries() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries +tags: + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries +original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries +--- +
{{JSRef}}
+ +

entries() 方法返回一个新的包含 [key, value] 对的 Iterator 对象，返回的迭代器的迭代顺序与 Map 对象的插入顺序相同。

+ +

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

+ +

语法

+ +
myMap.entries()
+
+ +

返回值

+ +

一个新的 {{jsxref("Map")}} 迭代器对象.

+ +

示例

+ +

entries()的使用

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.entries();
+
+console.log(mapIter.next().value); // ["0", "foo"]
+console.log(mapIter.next().value); // [1, "bar"]
+console.log(mapIter.next().value); // [Object, "baz"]
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}}
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
+ +

浏览器兼容性

+ +

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

+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/foreach/index.html new file mode 100644 index 0000000000..b15bd716d9 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/foreach/index.html @@ -0,0 +1,110 @@ +--- +title: Map.prototype.forEach() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach +original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach +--- +
{{JSRef}}
+ +

forEach() 方法按照插入顺序依次对 Map 中每个键/值对执行一次给定的函数

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

语法

+ +
myMap.forEach(callback([value][,key][,map])[, thisArg])
+ +

参数

+ +
+
callback
+
+

myMap 中每个元素所要执行的函数。它具有如下的参数

+ +
+
value {{Optional_Inline}}
+
每个迭代的值。
+
key {{Optional_Inline}}
+
每个迭代的键。
+
map {{Optional_Inline}}
+
被迭代的map（上文语法框中的 myMap）。
+
+
+
thisArg {{Optional_Inline}}
+
在 callback 执行中使用的 this 的值。
+
+ +

返回值

+ +

{{jsxref("undefined")}}.

+ +

描述

+ +

forEach 方法会对map中每个真实存在的键执行一次给定的 callback 函数。它不会对被删除的键执行函数。然而，它会对每个值为 undefined 的键执行函数。

+ +

callback 接收三个参数：

+ + + +

如果 forEach 中含有 thisArg 参数，那么每次 callback 被调用时，都会被用作 this 的值。否则，undefined 将会被用作 this 的值。按照函数观察到 this 的常用规则，callback 函数最终可观察到 this 值。

+ +

每个值只被访问一次，除非它被删除了或者在 forEach 结束前被改变了。callback 不会对在被访问前就删除的元素执行。在 forEach 结束前被添加的元素将会被访问。

+ +

forEach 会对 Map 对象中的每个元素执行一次 callback。它不会返回值。

+ +

示例

+ +

输出一个 Map 对象中的内容

+ +

以下的代码在每行中打印一个 Map 对象中的元素

+ +
function logMapElements(value, key, map) {
+    console.log(`map.get('${key}') = ${value}`)
+}
+new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements)
+// logs:
+// "map.get('foo') = 3"
+// "map.get('bar') = [object Object]"
+// "map.get('baz') = undefined"
+
+ +

规范

+ + + + + + + + + + + + +
规范
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}
+ +

浏览器兼容

+ + + +

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

+ +

参见

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/get/index.html new file mode 100644 index 0000000000..e9f46c82c5 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/get/index.html @@ -0,0 +1,82 @@ +--- +title: Map.prototype.get() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Prototype + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Map/get +original_slug: Web/JavaScript/Reference/Global_Objects/Map/get +--- +
{{JSRef}}
+ +

get() 方法返回某个 Map 对象中的一个指定元素。

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

语法

+ +
myMap.get(key);
+ +

参数

+ +
+
key
+
必须参数，也是它唯一的参数，要从目标 Map 对象中获取的元素的键。
+
+ +

返回值

+ +

返回一个 Map 对象中与指定键相关联的值，如果找不到这个键则返回 undefined。

+ +

示例

+ +

使用 get 方法

+ +
var myMap = new Map();
+myMap.set("bar", "foo");
+
+myMap.get("bar");  // 返回 "foo"
+myMap.get("baz");  // 返回 undefined
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容性

+ + + +

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

+ +

参见

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/has/index.html new file mode 100644 index 0000000000..b71c051a98 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/has/index.html @@ -0,0 +1,121 @@ +--- +title: Map.prototype.has() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Method + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Map/has +original_slug: Web/JavaScript/Reference/Global_Objects/Map/has +--- +
{{JSRef}}
+ +

方法has() 返回一个bool值，用来表明map 中是否存在指定元素.

+ +

语法

+ +
myMap.has(key);
+ +

参数

+ +
+
key
+
必填. 用来检测是否存在指定元素的键值.
+
+ +

返回值

+ +
+
Boolean
+
如果指定元素存在于Map中，则返回true。其他情况返回false
+
+ +

案例

+ +

使用has方法

+ +
var myMap = new Map();
+myMap.set("bar", "foo");
+
+myMap.has("bar");  // returns true
+myMap.has("baz");  // returns false
+
+ +

规范列表

+ + + + + + + + + + + + + + +
规范名称StatusComment
{{SpecName('ES6', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES6')}}Initial definition.
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
浏览器Chrome谷歌Firefox (Gecko)火狐Internet ExplorerOperaSafari
兼容版本38{{CompatGeckoDesktop("13.0")}}11257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
浏览器AndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
兼容版本{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
+
+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..dbd2a9aadd --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,341 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript6 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
+
{{JSRef}}
+
+ +

Map 对象保存键值对，并且能够记住键的原始插入顺序。任何值(对象或者{{Glossary("Primitive", "原始值")}}) 都可以作为一个键或一个值。

+ +
+
+ +

描述

+ +

一个Map对象在迭代时会根据对象中元素的插入顺序来进行 — 一个  {{jsxref("Statements/for...of", "for...of")}} 循环在每次迭代后会返回一个形式为[key，value]的数组。

+ +

键的相等(Key equality)

+ + + +

Objects 和 maps 的比较

+ +

{{jsxref("Object", "Objects")}} 和 Maps 类似的是，它们都允许你按键存取一个值、删除键、检测一个键是否绑定了值。因此（并且也没有其他内建的替代方式了）过去我们一直都把对象当成 Maps 使用。不过 Maps 和 Objects 有一些重要的区别，在下列情况里使用 Map 会是更好的选择：

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MapObject
意外的键Map 默认情况不包含任何键。只包含显式插入的键。 +

一个 Object 有一个原型, 原型链上的键名有可能和你自己在对象上的设置的键名产生冲突。

+ +
+

注意: 虽然 ES5 开始可以用 Object.create(null) 来创建一个没有原型的对象，但是这种用法不太常见。

+
+
键的类型一个 Map的键可以是任意值，包括函数、对象或任意基本类型。一个Object 的键必须是一个 {{jsxref("String")}} 或是{{jsxref("Symbol")}}。
键的顺序 +

Map 中的 key 是有序的。因此，当迭代的时候，一个 Map 对象以插入的顺序返回键值。

+ 		+

一个 Object 的键是无序的

+ +
+

注意：自ECMAScript 2015规范以来，对象确实保留了字符串和Symbol键的创建顺序； 因此，在只有字符串键的对象上进行迭代将按插入顺序产生键。

+
+
Size Map 的键值对个数可以轻易地通过{{jsxref("Map.prototype.size", "size")}} 属性获取Object 的键值对个数只能手动计算
迭代Map 是 iterable 的，所以可以直接被迭代。迭代一个Object需要以某种方式获取它的键然后才能迭代。
性能 +

在频繁增删键值对的场景下表现更好。

+ 		+

在频繁添加和删除键值对的场景下未作出优化。

+
+ +

构造函数

+ +
+
{{jsxref("Global_Objects/Map/Map", "Map()")}}
+
创建 Map 对象
+
+ +

属性

+ +
+
Map.length
+
属性 length 的值为 0 。
+ 想要计算一个Map 中的条目数量， 使用 {{jsxref("Map.prototype.size")}}.
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
本构造函数用于创建派生对象。
+
{{jsxref("Map.prototype")}}
+
表示 Map 构造器的原型。 允许添加属性从而应用于所有的 Map 对象。
+
+ +

Map 实例

+ +

所有的 Map 对象实例都会继承 {{jsxref("Map.prototype")}}。

+ +

属性

+ +

{{page('zh-CN/Web/JavaScript/Reference/Global_Objects/Map/prototype','属性')}}

+ +

方法

+ +

{{page('zh-CN/Web/JavaScript/Reference/Global_Objects/Map/prototype','方法')}}

+ +

示例

+ +

使用 Map 对象

+ +
let myMap = new Map();
+
+let keyObj = {};
+let keyFunc = function() {};
+let keyString = 'a string';
+
+// 添加键
+myMap.set(keyString, "和键'a string'关联的值");
+myMap.set(keyObj, "和键keyObj关联的值");
+myMap.set(keyFunc, "和键keyFunc关联的值");
+
+myMap.size; // 3
+
+// 读取值
+myMap.get(keyString);    // "和键'a string'关联的值"
+myMap.get(keyObj);       // "和键keyObj关联的值"
+myMap.get(keyFunc);      // "和键keyFunc关联的值"
+
+myMap.get('a string');   // "和键'a string'关联的值"
+                         // 因为keyString === 'a string'
+myMap.get({});           // undefined, 因为keyObj !== {}
+myMap.get(function() {}); // undefined, 因为keyFunc !== function () {}
+ +

将 NaN 作为 Map 的键

+ +

NaN 也可以作为Map对象的键。虽然 NaN 和任何值甚至和自己都不相等(NaN !== NaN 返回true)，但下面的例子表明，NaN作为Map的键来说是没有区别的:

+ +
let myMap = new Map();
+myMap.set(NaN, "not a number");
+
+myMap.get(NaN); // "not a number"
+
+let otherNaN = Number("foo");
+myMap.get(otherNaN); // "not a number"
+
+ +

使用 for..of 方法迭代 Map

+ +

Map可以使用for..of循环来实现迭代：

+ +
let myMap = new Map();
+myMap.set(0, "zero");
+myMap.set(1, "one");
+for (let [key, value] of myMap) {
+  console.log(key + " = " + value);
+}
+// 将会显示两个log。一个是"0 = zero"另一个是"1 = one"
+
+for (let key of myMap.keys()) {
+  console.log(key);
+}
+// 将会显示两个log。 一个是 "0" 另一个是 "1"
+
+for (let value of myMap.values()) {
+  console.log(value);
+}
+// 将会显示两个log。 一个是 "zero" 另一个是 "one"
+
+for (let [key, value] of myMap.entries()) {
+  console.log(key + " = " + value);
+}
+// 将会显示两个log。 一个是 "0 = zero" 另一个是 "1 = one"
+ +

使用 forEach() 方法迭代 Map

+ +

Map也可以通过forEach()方法迭代：

+ +
myMap.forEach(function(value, key) {
+  console.log(key + " = " + value);
+})
+// 将会显示两个logs。 一个是 "0 = zero" 另一个是 "1 = one"
+
+ +

Map 与数组的关系

+ +
let kvArray = [["key1", "value1"], ["key2", "value2"]];
+
+// 使用常规的Map构造函数可以将一个二维键值对数组转换成一个Map对象
+let myMap = new Map(kvArray);
+
+myMap.get("key1"); // 返回值为 "value1"
+
+// 使用Array.from函数可以将一个Map对象转换成一个二维键值对数组
+console.log(Array.from(myMap)); // 输出和kvArray相同的数组
+
+// 更简洁的方法来做如上同样的事情，使用展开运算符
+console.log([...myMap]);
+
+// 或者在键或者值的迭代器上使用Array.from，进而得到只含有键或者值的数组
+console.log(Array.from(myMap.keys())); // 输出 ["key1", "key2"]
+
+ +

复制或合并 Maps

+ +

Map 能像数组一样被复制：

+ +
let original = new Map([
+  [1, 'one']
+]);
+
+let clone = new Map(original);
+
+console.log(clone.get(1)); // one
+console.log(original === clone); // false. 浅比较 不为同一个对象的引用
+
+ +
+

重要：请记住，数据本身未被克隆。

+
+ +

Map对象间可以进行合并，但是会保持键的唯一性。

+ +
let first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+let second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// 合并两个Map对象时，如果有重复的键值，则后面的会覆盖前面的。
+// 展开运算符本质上是将Map对象转换成数组。
+let merged = new Map([...first, ...second]);
+
+console.log(merged.get(1)); // uno
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+ +

Map对象也能与数组合并：

+ +
let first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+let second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// Map对象同数组进行合并时，如果有重复的键值，则后面的会覆盖前面的。
+let merged = new Map([...first, ...second, [1, 'eins']]);
+
+console.log(merged.get(1)); // eins
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+ +

使用说明

+ +

请注意！为Map设置对象属性也是可以的，但是可能引起大量的混乱。

+ +

所以，你还是可以这样做...

+ +
let wrongMap = new Map()
+wrongMap['bla'] = 'blaa'
+wrongMap['bla2'] = 'blaaa2'
+
+console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
+
+ +

...但是，这样做的话，它的行为会不符合预期:

+ +
wrongMap.has('bla')    // false
+wrongMap.delete('bla') // false
+console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
+ +

无论如何，和正确用法比较起来，几乎没有什么不同: 

+ +
let myMap = new Map()
+myMap.set('bla','blaa')
+myMap.set('bla2','blaa2')
+console.log(myMap)  // Map { 'bla' => 'blaa', 'bla2' => 'blaa2' }
+
+myMap.has('bla')    // true
+myMap.delete('bla') // true
+console.log(myMap)  // Map { 'bla2' => 'blaa2' }
+ +

规范

+ + + + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
+ +

浏览器兼容性

+ + + +

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

+ +

相关链接

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/keys/index.html new file mode 100644 index 0000000000..057d5ee897 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/keys/index.html @@ -0,0 +1,80 @@ +--- +title: Map.prototype.keys() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys +tags: + - ECMAScript6 + - Iterator + - JavaScript + - Map + - Method + - Prototype + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys +original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys +--- +
{{JSRef}}
+ +

keys() 返回一个引用的 Iterator 对象。它包含按照顺序插入 Map 对象中每个元素的key值。

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

语法

+ +
myMap.keys()
+ +

返回值

+ +

一个存在引用关系的 {{jsxref("Map")}} iterator 对象.

+ +

例子

+ +

使用 keys()

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.keys();
+
+console.log(mapIter.next().value); // "0"
+console.log(mapIter.next().value); // 1
+console.log(mapIter.next().value); // Object
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}}
+ +

浏览器兼容性

+ + + +

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

+ +

参见

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/map/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/map/index.html new file mode 100644 index 0000000000..974e3a73b0 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/map/index.html @@ -0,0 +1,58 @@ +--- +title: Map() 构造函数 +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map/Map +--- +
{{JSRef}}
+ +

Map() 构造函数 创建 {{jsxref("Map")}} 对象.

+ +

语法

+ +
new Map([iterable])
+ +

参数

+ +
+
iterable
+
Iterable 可以是一个{{jsxref("Array", "数组")}}或者其他 iterable 对象，其元素为键值对(两个元素的数组，例如: [[ 1, 'one' ],[ 2, 'two' ]])。 每个键值对都会添加到新的 Map。null 会被当做 undefined。
+
+ +

示例

+ +
let myMap = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+])
+
+ +

Specifications

+ + + + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
+ +

Browser compatibility

+ + + +

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

+ +

See also

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/set/index.html new file mode 100644 index 0000000000..9e7ad91ba5 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/set/index.html @@ -0,0 +1,97 @@ +--- +title: Map.prototype.set() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set +tags: + - ECMAScript6 + - JavaScript + - Map + - Method + - Prototype + - 方法 +translation_of: Web/JavaScript/Reference/Global_Objects/Map/set +original_slug: Web/JavaScript/Reference/Global_Objects/Map/set +--- +

{{JSRef}}

+ +

set() 方法为 Map 对象添加或更新一个指定了键（key）和值（value）的（新）键值对。

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

语法

+ +
myMap.set(key, value);
+ +

参数

+ +
+
key
+
要添加至相应 Map 对象的元素的键。
+
value
+
要添加至相应 Map 对象的元素的值。
+
+ +

返回值

+ +

Map 对象

+ +

示例

+ +

使用 set 方法

+ +
var myMap = new Map();
+
+// 将一个新元素添加到 Map 对象
+myMap.set("bar", "foo");
+myMap.set(1, "foobar");
+
+// 在Map对象中更新某个元素的值
+myMap.set("bar", "baz");
+
+ +

链式使用 set 方法

+ +

因为 Set() 方法返回 Map 对象本身，所以你可以像下面这样链式调用它:

+ +
// Add new elements to the map with chaining.
+myMap.set('bar', 'foo')
+     .set(1, 'foobar')
+     .set(2, 'baz');
+
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}}
+ +

浏览器兼容性

+ + + +

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

+ +

参见

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/size/index.html new file mode 100644 index 0000000000..585d04f70a --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/size/index.html @@ -0,0 +1,78 @@ +--- +title: Map.prototype.size +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size +tags: + - ECMAScript 2015 + - JavaScript + - Map + - Property +translation_of: Web/JavaScript/Reference/Global_Objects/Map/size +original_slug: Web/JavaScript/Reference/Global_Objects/Map/size +--- +
{{JSRef}}
+ 
+ +

size 是可访问属性，用于返回 一个{{jsxref("Map")}} 对象的成员数量。

+ +

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

+ +

这个示例源码保存在GitHub：https://github.com/mdn/interactive-examples。如果你想贡献代码，修改后在GitHub上发推送请求给我们。

+ +

 

+ +

描述

+ +

size 属性的值是一个整数，表示 Map 对象有多少个键值对。size 是只读属性，用set 方法修改size返回 undefined，即不能改变它的值。

+ +

示例

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

规范

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容

+ +

此页的兼容性表格请查阅：https://github.com/mdn/browser-compat-data 
+ 如果你想更新数据，请在GitHub上给我们发推送请求。

+ +
+

异常提醒

+
+ + + +

相关阅读

+ + diff --git a/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/values/index.html new file mode 100644 index 0000000000..29fad63c96 --- /dev/null +++ b/files/zh-cn/orphaned/web/javascript/reference/global_objects/map/values/index.html @@ -0,0 +1,113 @@ +--- +title: Map.prototype.values() +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values +translation_of: Web/JavaScript/Reference/Global_Objects/Map/values +original_slug: Web/JavaScript/Reference/Global_Objects/Map/values +--- +
values() 方法返回一个新的Iterator对象。它包含按顺序插入Map对象中每个元素的value值。
+ +
 
+ +

语法

+ +
myMap.values()
+ +

返回值

+ +

一个新的 Map 可迭代对象.

+ +

例子

+ +

使用 values()

+ +
var myMap = new Map();
+myMap.set("0", "foo");
+myMap.set(1, "bar");
+myMap.set({}, "baz");
+
+var mapIter = myMap.values();
+
+console.log(mapIter.next().value); // "foo"
+console.log(mapIter.next().value); // "bar"
+console.log(mapIter.next().value); // "baz"
+ +

规范

+ + + + + + + + + + + + + + + + + + + +
规范状态备注
{{SpecName('ES6', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES6')}}初始定义
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{ CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
+
+ +

查看

+ + diff --git a/files/zh-cn/web/api/node/getuserdata/index.html b/files/zh-cn/web/api/node/getuserdata/index.html deleted file mode 100644 index cc81f8c288..0000000000 --- a/files/zh-cn/web/api/node/getuserdata/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Node.getUserData() -slug: Web/API/Node/getUserData -translation_of: Web/API/Node/getUserData ---- -

{{ APIRef }}{{ obsolete_header() }}

-

The Node.getUserData() method returns any user {{domxref("DOMUserData")}} set previously on the given node by {{domxref("Node.setUserData()")}}.

-
-

The Node.setUserData and {{domxref("Node.getUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

-
-

Syntax

-
userData = someNode.getUserData(userKey);
-

Parameters

- -

Example

-
var d = document.setUserData('key', 15, null);
-alert(document.getUserData('key')); // 15
-

Specifications

- - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}{{Spec2('DOM3 Core')}}Initial definition.
-

Browser compatibility

-

{{CompatibilityTable}}

-
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}Supported from {{CompatGeckoDesktop("1.0")}} to {{CompatGeckoDesktop("21.0")}}.
- Removed in {{CompatGeckoDesktop("22.0")}} [1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - -
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}Supported from {{CompatGeckoMobile("1.0")}} to {{CompatGeckoMobile("21.0")}}.
- Removed in {{CompatGeckoMobile("22.0")}} [1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
-
-

[1] The method is still available from chrome scripts.

-

See also

- diff --git a/files/zh-cn/web/api/node/setuserdata/index.html b/files/zh-cn/web/api/node/setuserdata/index.html deleted file mode 100644 index 2729b79c50..0000000000 --- a/files/zh-cn/web/api/node/setuserdata/index.html +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: Node.setUserData() -slug: Web/API/Node/setUserData -translation_of: Web/API/Node/setUserData ---- -

{{ APIRef }}{{ obsolete_header() }}

-

The Node.setUserData() method allows a user to attach (or remove) data to an element, without needing to modify the DOM. Note that such data will not be preserved when imported via {{domxref("Node.importNode")}}, as with {{domxref("Node.cloneNode()")}} and {{domxref("Node.renameNode()")}} operations (though {{domxref("Node.adoptNode")}} does preserve the information), and equality tests in {{domxref("Node.isEqualNode()")}} do not consider user data in making the assessment.

-

This method offers the convenience of associating data with specific nodes without needing to alter the structure of a document and in a standard fashion, but it also means that extra steps may need to be taken if one wishes to serialize the information or include the information upon clone, import, or rename operations.

-
-

The Node.getUserData and {{domxref("Node.setUserData")}} methods are no longer available from Web content. {{domxref("Element.dataset")}} or WeakMap can be used instead.

-
-

Syntax

-
prevUserData = someNode.setUserData(userKey, userData, handler);
-

Parameters

- -

Example

-
var d = document.implementation.createDocument('', 'test', null);
-d.documentElement.setUserData('key', 15, {handle:function (o, k, d, s, ds) {alert(o+'::'+k+'::'+d+'::'+s+'::'+ds)}}); // 2::key::15::[object Element]::[object Element]
-alert(d.documentElement.getUserData('key')); // 15
-var e = document.importNode(d.documentElement, true); // causes handler to be called
-alert(e.getUserData('key')); // null since user data is not copied
-
-

Specifications

- - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}{{Spec2('DOM WHATWG')}}Removed from the specification.
{{SpecName('DOM3 Core', 'core.html#Node3-setUserData', 'Node.setUserData()')}}{{Spec2('DOM3 Core')}}Initial definition.
-

Browser compatibility

-

{{CompatibilityTable}}

-
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatNo}}Supported from {{CompatGeckoDesktop("1.0")}} to {{CompatGeckoDesktop("21.0")}}.
- Removed in {{CompatGeckoDesktop("22.0")}} [1]		{{CompatUnknown}}{{CompatNo}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - -
FeatureAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}Supported from {{CompatGeckoMobile("1.0")}} to {{CompatGeckoMobile("21.0")}}.
- Removed in {{CompatGeckoMobile("22.0")}} [1]		{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}
-
-

[1] The method is still available from chrome scripts.

-

See also

- diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/@@iterator/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/@@iterator/index.html deleted file mode 100644 index aa4c789a26..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/@@iterator/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: 'Map.prototype[@@iterator]()' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@iterator -tags: - - ECMAScript 2015 - - Iterator - - JavaScript - - Map - - Method - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@iterator ---- -
{{JSRef}}
- -

@@iterator 属性的初始值与 {{jsxref("Map.prototype.entries()", "entries")}} 属性的初始值是同一个函数对象。

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

语法

- -
myMap[Symbol.iterator]
- -

返回值

- -

map 的 iterator 函数默认就是 {{jsxref("Map.prototype.entries()", "entries()")}} 函数。

- -

示例

- -

使用 [@@iterator]()

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-var mapIter = myMap[Symbol.iterator]();
-//返回的其实是个generator
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

在for..of中使用[@@iterator]() 

- -
var myMap = new Map();
-myMap.set('0', 'foo');
-myMap.set(1, 'bar');
-myMap.set({}, 'baz');
-
-for (const entry of myMap) {
-  console.log(entry);
-}
-// ["0", "foo"]
-// [1, "bar"]
-// [{}, "baz"]
-
-for (var v of myMap) {
-  console.log(v);
-}
-
-// 0: foo
-// 1: bar
-// [Object]: baz
- -

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@iterator', 'Map.prototype[@@iterator]()')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容

- - - -

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

- -

另见

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/@@species/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index ded2acd30b..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: 'get Map[@@species]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@species -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -
{{JSRef}}
- -

 Map[@@species] 访问器属性会返回一个 Map 构造函数.

- -

语法

- -
Map[Symbol.species]
-
- -

描述

- -

The species accessor property returns the default constructor for Map objects. Subclass constructors may over-ride it to change the constructor assignment.

- -

案例

- -

The species property returns the default constructor function, which is the Map constructor for Map objects:

- -
Map[Symbol.species]; // function Map()
- -

In a derived collection object (e.g. your custom map MyMap), the MyMap species is the MyMap constructor. However, you might want to overwrite this, in order to return parent Map objects in your derived class methods:

- -
class MyMap extends Map {
-  // 重写覆盖 MyMap species to the parent Map constructor
-  static get [Symbol.species]() { return Map; }
-}
- -

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容性

- -
- - -

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

-
- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/@@tostringtag/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/@@tostringtag/index.html deleted file mode 100644 index c6a1e3c81b..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/@@tostringtag/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: 'Map.prototype[@@toStringTag]' -slug: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@toStringTag ---- -
{{JSRef}}
- -

 Map[@@toStringTag] 的初始值是"Map".

- -
{{js_property_attributes(0,0,1)}}
- -

语法

- -
Map[Symbol.toStringTag]
- -

示例

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

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype-@@tostringtag', 'Map.prototype[@@toStringTag]')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容

- -

{{CompatibilityTable}} 

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{ CompatChrome(44.0) }}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -
- - - - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidAndroid WebviewFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
Basic support{{ CompatNo }}{{ CompatChrome(44.0) }}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatNo}}{{CompatChrome(44.0)}}
-
diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/clear/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 8244d179c2..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Map.prototype.clear() -slug: Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -
{{JSRef}}
- -

clear()方法会移除Map对象中的所有元素。

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

语法

- -
myMap.clear();
-
- -

返回值

- -

{{jsxref("undefined")}}.

- -

示例

- -

调用clear方法

- -
var myMap = new Map();
-myMap.set("bar", "baz");
-myMap.set(1, "foo");
-
-myMap.size;       // 2
-myMap.has("bar"); // true
-
-myMap.clear();
-
-myMap.size;       // 0
-myMap.has("bar")  // false
-
- -

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容

- - - -

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

- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/delete/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 4b8fb98c3f..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Map.prototype.delete() -slug: Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -
{{JSRef}}
- -

 delete() 方法用于移除 Map 对象中指定的元素。

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

语法

- -
myMap.delete(key);
- -

参数

- -
-
key
-
必须。从 Map 对象中移除的元素的键。
-
- -

返回值

- -
-
Boolean
-
如果 Map 对象中存在该元素，则移除它并返回 true；否则如果该元素不存在则返回 false。
-
- -

示例

- -

使用 delete 方法

- -
var myMap = new Map();
-myMap.set("bar", "foo");
-
-myMap.delete("bar"); // 返回 true。成功地移除元素
-myMap.has("bar");    // 返回 false。"bar" 元素将不再存在于 Map 实例中
-
- -

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容性

- - - -

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

- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/entries/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index f97881755e..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.entries() -slug: Web/JavaScript/Reference/Global_Objects/Map/entries -tags: - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -
{{JSRef}}
- -

entries() 方法返回一个新的包含 [key, value] 对的 Iterator 对象，返回的迭代器的迭代顺序与 Map 对象的插入顺序相同。

- -

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

- -

语法

- -
myMap.entries()
-
- -

返回值

- -

一个新的 {{jsxref("Map")}} 迭代器对象.

- -

示例

- -

entries()的使用

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.entries();
-
-console.log(mapIter.next().value); // ["0", "foo"]
-console.log(mapIter.next().value); // [1, "bar"]
-console.log(mapIter.next().value); // [Object, "baz"]
-
- -

规范

- - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ESDraft')}}
{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}{{Spec2('ES2015')}}Initial definition.
- -

浏览器兼容性

- -

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

- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/foreach/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index f6540d7412..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: Web/JavaScript/Reference/Global_Objects/Map/forEach -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -
{{JSRef}}
- -

forEach() 方法按照插入顺序依次对 Map 中每个键/值对执行一次给定的函数

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

语法

- -
myMap.forEach(callback([value][,key][,map])[, thisArg])
- -

参数

- -
-
callback
-
-

myMap 中每个元素所要执行的函数。它具有如下的参数

- -
-
value {{Optional_Inline}}
-
每个迭代的值。
-
key {{Optional_Inline}}
-
每个迭代的键。
-
map {{Optional_Inline}}
-
被迭代的map（上文语法框中的 myMap）。
-
-
-
thisArg {{Optional_Inline}}
-
在 callback 执行中使用的 this 的值。
-
- -

返回值

- -

{{jsxref("undefined")}}.

- -

描述

- -

forEach 方法会对map中每个真实存在的键执行一次给定的 callback 函数。它不会对被删除的键执行函数。然而，它会对每个值为 undefined 的键执行函数。

- -

callback 接收三个参数：

- - - -

如果 forEach 中含有 thisArg 参数，那么每次 callback 被调用时，都会被用作 this 的值。否则，undefined 将会被用作 this 的值。按照函数观察到 this 的常用规则，callback 函数最终可观察到 this 值。

- -

每个值只被访问一次，除非它被删除了或者在 forEach 结束前被改变了。callback 不会对在被访问前就删除的元素执行。在 forEach 结束前被添加的元素将会被访问。

- -

forEach 会对 Map 对象中的每个元素执行一次 callback。它不会返回值。

- -

示例

- -

输出一个 Map 对象中的内容

- -

以下的代码在每行中打印一个 Map 对象中的元素

- -
function logMapElements(value, key, map) {
-    console.log(`map.get('${key}') = ${value}`)
-}
-new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements)
-// logs:
-// "map.get('foo') = 3"
-// "map.get('bar') = [object Object]"
-// "map.get('baz') = undefined"
-
- -

规范

- - - - - - - - - - - - -
规范
{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}
- -

浏览器兼容

- - - -

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

- -

参见

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/get/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 1de9947bc4..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Map.prototype.get() -slug: Web/JavaScript/Reference/Global_Objects/Map/get -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Prototype - - 方法 -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get ---- -
{{JSRef}}
- -

get() 方法返回某个 Map 对象中的一个指定元素。

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

语法

- -
myMap.get(key);
- -

参数

- -
-
key
-
必须参数，也是它唯一的参数，要从目标 Map 对象中获取的元素的键。
-
- -

返回值

- -

返回一个 Map 对象中与指定键相关联的值，如果找不到这个键则返回 undefined。

- -

示例

- -

使用 get 方法

- -
var myMap = new Map();
-myMap.set("bar", "foo");
-
-myMap.get("bar");  // 返回 "foo"
-myMap.get("baz");  // 返回 undefined
-
- -

规范

- - - - - - - - - - - - - - - - - - - -
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容性

- - - -

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

- -

参见

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/has/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index 73eb4550d0..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: Map.prototype.has() -slug: Web/JavaScript/Reference/Global_Objects/Map/has -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Method - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has ---- -
{{JSRef}}
- -

方法has() 返回一个bool值，用来表明map 中是否存在指定元素.

- -

语法

- -
myMap.has(key);
- -

参数

- -
-
key
-
必填. 用来检测是否存在指定元素的键值.
-
- -

返回值

- -
-
Boolean
-
如果指定元素存在于Map中，则返回true。其他情况返回false
-
- -

案例

- -

使用has方法

- -
var myMap = new Map();
-myMap.set("bar", "foo");
-
-myMap.has("bar");  // returns true
-myMap.has("baz");  // returns false
-
- -

规范列表

- - - - - - - - - - - - - - -
规范名称StatusComment
{{SpecName('ES6', '#sec-map.prototype.has', 'Map.prototype.has')}}{{Spec2('ES6')}}Initial definition.
- -

浏览器兼容性

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
浏览器Chrome谷歌Firefox (Gecko)火狐Internet ExplorerOperaSafari
兼容版本38{{CompatGeckoDesktop("13.0")}}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
浏览器AndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
兼容版本{{CompatNo}}38{{CompatGeckoMobile("13.0")}}{{CompatNo}}{{CompatNo}}8
-
- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index b84dfb2304..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,340 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript6 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
-
{{JSRef}}
-
- -

Map 对象保存键值对，并且能够记住键的原始插入顺序。任何值(对象或者{{Glossary("Primitive", "原始值")}}) 都可以作为一个键或一个值。

- -
-
- -

描述

- -

一个Map对象在迭代时会根据对象中元素的插入顺序来进行 — 一个  {{jsxref("Statements/for...of", "for...of")}} 循环在每次迭代后会返回一个形式为[key，value]的数组。

- -

键的相等(Key equality)

- - - -

Objects 和 maps 的比较

- -

{{jsxref("Object", "Objects")}} 和 Maps 类似的是，它们都允许你按键存取一个值、删除键、检测一个键是否绑定了值。因此（并且也没有其他内建的替代方式了）过去我们一直都把对象当成 Maps 使用。不过 Maps 和 Objects 有一些重要的区别，在下列情况里使用 Map 会是更好的选择：

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MapObject
意外的键Map 默认情况不包含任何键。只包含显式插入的键。 -

一个 Object 有一个原型, 原型链上的键名有可能和你自己在对象上的设置的键名产生冲突。

- -
-

注意: 虽然 ES5 开始可以用 Object.create(null) 来创建一个没有原型的对象，但是这种用法不太常见。

-
-
键的类型一个 Map的键可以是任意值，包括函数、对象或任意基本类型。一个Object 的键必须是一个 {{jsxref("String")}} 或是{{jsxref("Symbol")}}。
键的顺序 -

Map 中的 key 是有序的。因此，当迭代的时候，一个 Map 对象以插入的顺序返回键值。

- 		-

一个 Object 的键是无序的

- -
-

注意：自ECMAScript 2015规范以来，对象确实保留了字符串和Symbol键的创建顺序； 因此，在只有字符串键的对象上进行迭代将按插入顺序产生键。

-
-
Size Map 的键值对个数可以轻易地通过{{jsxref("Map.prototype.size", "size")}} 属性获取Object 的键值对个数只能手动计算
迭代Map 是 iterable 的，所以可以直接被迭代。迭代一个Object需要以某种方式获取它的键然后才能迭代。
性能 -

在频繁增删键值对的场景下表现更好。

- 		-

在频繁添加和删除键值对的场景下未作出优化。

-
- -

构造函数

- -
-
{{jsxref("Global_Objects/Map/Map", "Map()")}}
-
创建 Map 对象
-
- -

属性

- -
-
Map.length
-
属性 length 的值为 0 。
- 想要计算一个Map 中的条目数量， 使用 {{jsxref("Map.prototype.size")}}.
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
本构造函数用于创建派生对象。
-
{{jsxref("Map.prototype")}}
-
表示 Map 构造器的原型。 允许添加属性从而应用于所有的 Map 对象。
-
- -

Map 实例

- -

所有的 Map 对象实例都会继承 {{jsxref("Map.prototype")}}。

- -

属性

- -

{{page('zh-CN/Web/JavaScript/Reference/Global_Objects/Map/prototype','属性')}}

- -

方法

- -

{{page('zh-CN/Web/JavaScript/Reference/Global_Objects/Map/prototype','方法')}}

- -

示例

- -

使用 Map 对象

- -
let myMap = new Map();
-
-let keyObj = {};
-let keyFunc = function() {};
-let keyString = 'a string';
-
-// 添加键
-myMap.set(keyString, "和键'a string'关联的值");
-myMap.set(keyObj, "和键keyObj关联的值");
-myMap.set(keyFunc, "和键keyFunc关联的值");
-
-myMap.size; // 3
-
-// 读取值
-myMap.get(keyString);    // "和键'a string'关联的值"
-myMap.get(keyObj);       // "和键keyObj关联的值"
-myMap.get(keyFunc);      // "和键keyFunc关联的值"
-
-myMap.get('a string');   // "和键'a string'关联的值"
-                         // 因为keyString === 'a string'
-myMap.get({});           // undefined, 因为keyObj !== {}
-myMap.get(function() {}); // undefined, 因为keyFunc !== function () {}
- -

将 NaN 作为 Map 的键

- -

NaN 也可以作为Map对象的键。虽然 NaN 和任何值甚至和自己都不相等(NaN !== NaN 返回true)，但下面的例子表明，NaN作为Map的键来说是没有区别的:

- -
let myMap = new Map();
-myMap.set(NaN, "not a number");
-
-myMap.get(NaN); // "not a number"
-
-let otherNaN = Number("foo");
-myMap.get(otherNaN); // "not a number"
-
- -

使用 for..of 方法迭代 Map

- -

Map可以使用for..of循环来实现迭代：

- -
let myMap = new Map();
-myMap.set(0, "zero");
-myMap.set(1, "one");
-for (let [key, value] of myMap) {
-  console.log(key + " = " + value);
-}
-// 将会显示两个log。一个是"0 = zero"另一个是"1 = one"
-
-for (let key of myMap.keys()) {
-  console.log(key);
-}
-// 将会显示两个log。 一个是 "0" 另一个是 "1"
-
-for (let value of myMap.values()) {
-  console.log(value);
-}
-// 将会显示两个log。 一个是 "zero" 另一个是 "one"
-
-for (let [key, value] of myMap.entries()) {
-  console.log(key + " = " + value);
-}
-// 将会显示两个log。 一个是 "0 = zero" 另一个是 "1 = one"
- -

使用 forEach() 方法迭代 Map

- -

Map也可以通过forEach()方法迭代：

- -
myMap.forEach(function(value, key) {
-  console.log(key + " = " + value);
-})
-// 将会显示两个logs。 一个是 "0 = zero" 另一个是 "1 = one"
-
- -

Map 与数组的关系

- -
let kvArray = [["key1", "value1"], ["key2", "value2"]];
-
-// 使用常规的Map构造函数可以将一个二维键值对数组转换成一个Map对象
-let myMap = new Map(kvArray);
-
-myMap.get("key1"); // 返回值为 "value1"
-
-// 使用Array.from函数可以将一个Map对象转换成一个二维键值对数组
-console.log(Array.from(myMap)); // 输出和kvArray相同的数组
-
-// 更简洁的方法来做如上同样的事情，使用展开运算符
-console.log([...myMap]);
-
-// 或者在键或者值的迭代器上使用Array.from，进而得到只含有键或者值的数组
-console.log(Array.from(myMap.keys())); // 输出 ["key1", "key2"]
-
- -

复制或合并 Maps

- -

Map 能像数组一样被复制：

- -
let original = new Map([
-  [1, 'one']
-]);
-
-let clone = new Map(original);
-
-console.log(clone.get(1)); // one
-console.log(original === clone); // false. 浅比较 不为同一个对象的引用
-
- -
-

重要：请记住，数据本身未被克隆。

-
- -

Map对象间可以进行合并，但是会保持键的唯一性。

- -
let first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-let second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// 合并两个Map对象时，如果有重复的键值，则后面的会覆盖前面的。
-// 展开运算符本质上是将Map对象转换成数组。
-let merged = new Map([...first, ...second]);
-
-console.log(merged.get(1)); // uno
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
- -

Map对象也能与数组合并：

- -
let first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-let second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// Map对象同数组进行合并时，如果有重复的键值，则后面的会覆盖前面的。
-let merged = new Map([...first, ...second, [1, 'eins']]);
-
-console.log(merged.get(1)); // eins
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
- -

使用说明

- -

请注意！为Map设置对象属性也是可以的，但是可能引起大量的混乱。

- -

所以，你还是可以这样做...

- -
let wrongMap = new Map()
-wrongMap['bla'] = 'blaa'
-wrongMap['bla2'] = 'blaaa2'
-
-console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
-
- -

...但是，这样做的话，它的行为会不符合预期:

- -
wrongMap.has('bla')    // false
-wrongMap.delete('bla') // false
-console.log(wrongMap)  // Map { bla: 'blaa', bla2: 'blaaa2' }
- -

无论如何，和正确用法比较起来，几乎没有什么不同: 

- -
let myMap = new Map()
-myMap.set('bla','blaa')
-myMap.set('bla2','blaa2')
-console.log(myMap)  // Map { 'bla' => 'blaa', 'bla2' => 'blaa2' }
-
-myMap.has('bla')    // true
-myMap.delete('bla') // true
-console.log(myMap)  // Map { 'bla2' => 'blaa2' }
- -

规范

- - - - - - - - - - - - -
Specification
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}
- -

浏览器兼容性

- - - -

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

- -

相关链接

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/keys/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index 5d27dffc82..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Map.prototype.keys() -slug: Web/JavaScript/Reference/Global_Objects/Map/keys -tags: - - ECMAScript6 - - Iterator - - JavaScript - - Map - - Method - - Prototype - - 方法 -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -
{{JSRef}}
- -

keys() 返回一个引用的 Iterator 对象。它包含按照顺序插入 Map 对象中每个元素的key值。

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

语法

- -
myMap.keys()
- -

返回值

- -

一个存在引用关系的 {{jsxref("Map")}} iterator 对象.

- -

例子

- -

使用 keys()

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.keys();
-
-console.log(mapIter.next().value); // "0"
-console.log(mapIter.next().value); // 1
-console.log(mapIter.next().value); // Object
-
- -

规范

- - - - - - - - - - - - - - - - - - - -
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}{{Spec2('ESDraft')}}
- -

浏览器兼容性

- - - -

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

- -

参见

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/map/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/map/index.html deleted file mode 100644 index 643f5b2b4d..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/map/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: Map() 构造函数 -slug: Web/JavaScript/Reference/Global_Objects/Map/Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map/Map ---- -
{{JSRef}}
- -

Map() 构造函数 创建 {{jsxref("Map")}} 对象.

- -

语法

- -
new Map([iterable])
- -

参数

- -
-
iterable
-
Iterable 可以是一个{{jsxref("Array", "数组")}}或者其他 iterable 对象，其元素为键值对(两个元素的数组，例如: [[ 1, 'one' ],[ 2, 'two' ]])。 每个键值对都会添加到新的 Map。null 会被当做 undefined。
-
- -

示例

- -
let myMap = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-])
-
- -

Specifications

- - - - - - - - - - - - -
Specification
{{SpecName('ESDraft', '#sec-map-constructor', 'Map constructor')}}
- -

Browser compatibility

- - - -

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

- -

See also

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/set/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index 0bdd4579ae..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Map.prototype.set() -slug: Web/JavaScript/Reference/Global_Objects/Map/set -tags: - - ECMAScript6 - - JavaScript - - Map - - Method - - Prototype - - 方法 -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set ---- -

{{JSRef}}

- -

set() 方法为 Map 对象添加或更新一个指定了键（key）和值（value）的（新）键值对。

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

语法

- -
myMap.set(key, value);
- -

参数

- -
-
key
-
要添加至相应 Map 对象的元素的键。
-
value
-
要添加至相应 Map 对象的元素的值。
-
- -

返回值

- -

Map 对象

- -

示例

- -

使用 set 方法

- -
var myMap = new Map();
-
-// 将一个新元素添加到 Map 对象
-myMap.set("bar", "foo");
-myMap.set(1, "foobar");
-
-// 在Map对象中更新某个元素的值
-myMap.set("bar", "baz");
-
- -

链式使用 set 方法

- -

因为 Set() 方法返回 Map 对象本身，所以你可以像下面这样链式调用它:

- -
// Add new elements to the map with chaining.
-myMap.set('bar', 'foo')
-     .set(1, 'foobar')
-     .set(2, 'baz');
-
- -

规范

- - - - - - - - - - - - - - - - - - - -
规范状态备注
{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}{{Spec2('ESDraft')}}
- -

浏览器兼容性

- - - -

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

- -

参见

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/size/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 14fb449e92..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.size -slug: Web/JavaScript/Reference/Global_Objects/Map/size -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size ---- -
{{JSRef}}
- 
- -

size 是可访问属性，用于返回 一个{{jsxref("Map")}} 对象的成员数量。

- -

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

- -

这个示例源码保存在GitHub：https://github.com/mdn/interactive-examples。如果你想贡献代码，修改后在GitHub上发推送请求给我们。

- -

 

- -

描述

- -

size 属性的值是一个整数，表示 Map 对象有多少个键值对。size 是只读属性，用set 方法修改size返回 undefined，即不能改变它的值。

- -

示例

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

规范

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容

- -

此页的兼容性表格请查阅：https://github.com/mdn/browser-compat-data 
- 如果你想更新数据，请在GitHub上给我们发推送请求。

- -
-

异常提醒

-
- - - -

相关阅读

- - diff --git a/files/zh-cn/web/javascript/reference/global_objects/map/values/index.html b/files/zh-cn/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 30336e98ce..0000000000 --- a/files/zh-cn/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: Map.prototype.values() -slug: Web/JavaScript/Reference/Global_Objects/Map/values -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values ---- -
values() 方法返回一个新的Iterator对象。它包含按顺序插入Map对象中每个元素的value值。
- -
 
- -

语法

- -
myMap.values()
- -

返回值

- -

一个新的 Map 可迭代对象.

- -

例子

- -

使用 values()

- -
var myMap = new Map();
-myMap.set("0", "foo");
-myMap.set(1, "bar");
-myMap.set({}, "baz");
-
-var mapIter = myMap.values();
-
-console.log(mapIter.next().value); // "foo"
-console.log(mapIter.next().value); // "bar"
-console.log(mapIter.next().value); // "baz"
- -

规范

- - - - - - - - - - - - - - - - - - - -
规范状态备注
{{SpecName('ES6', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ES6')}}初始定义
{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}{{Spec2('ESDraft')}} 
- -

浏览器兼容性

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support38{{ CompatGeckoDesktop("20") }}{{CompatNo}}257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}38{{ CompatGeckoMobile("20") }}{{CompatNo}}{{CompatNo}}8
-
- -

查看

- - diff --git a/files/zh-tw/_redirects.txt b/files/zh-tw/_redirects.txt index fca7a3d49b..446389f5f6 100644 --- a/files/zh-tw/_redirects.txt +++ b/files/zh-tw/_redirects.txt @@ -809,6 +809,7 @@ /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/ArrayBuffer /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Date/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Date /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Function +/zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Map /zh-TW/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Object /zh-TW/docs/Web/JavaScript/Reference/Global_Objects/Promise/prototype /zh-TW/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Promise diff --git a/files/zh-tw/_wikihistory.json b/files/zh-tw/_wikihistory.json index e038b792e9..fbab448b5a 100644 --- a/files/zh-tw/_wikihistory.json +++ b/files/zh-tw/_wikihistory.json @@ -7117,15 +7117,6 @@ "SolomonKang" ] }, - "Web/JavaScript/Reference/Global_Objects/Map": { - "modified": "2020-10-15T21:51:34.887Z", - "contributors": [ - "othree", - "tainenko", - "jackblackevo", - "jsgao0" - ] - }, "Web/JavaScript/Reference/Global_Objects/Math": { "modified": "2020-10-15T21:38:29.906Z", "contributors": [ @@ -9083,6 +9074,15 @@ "happysadman" ] }, + "orphaned/Web/JavaScript/Reference/Global_Objects/Map": { + "modified": "2020-10-15T21:51:34.887Z", + "contributors": [ + "othree", + "tainenko", + "jackblackevo", + "jsgao0" + ] + }, "orphaned/Web/Reference": { "modified": "2019-03-23T23:29:16.937Z", "contributors": [ diff --git a/files/zh-tw/orphaned/web/javascript/reference/global_objects/map/index.html b/files/zh-tw/orphaned/web/javascript/reference/global_objects/map/index.html new file mode 100644 index 0000000000..3d78305bea --- /dev/null +++ b/files/zh-tw/orphaned/web/javascript/reference/global_objects/map/index.html @@ -0,0 +1,266 @@ +--- +title: Map +slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map +tags: + - ECMAScript 2015 + - JavaScript + - Map +translation_of: Web/JavaScript/Reference/Global_Objects/Map +original_slug: Web/JavaScript/Reference/Global_Objects/Map +--- +
{{JSRef}}
+ +

Map 是保存了鍵值對（key-value pairs）的物件。任何值（包括物件及{{Glossary("Primitive", "基本型別（primitive）值")}}）都可以作為鍵或值。

+ +

語法

+ +
new Map([iterable])
+ +

參數

+ +
+
iterable
+
為一個{{jsxref("Array", "陣列")}}或其他元素成鍵值對的可迭代物件（有兩個元素的陣列，例如 [[ 1, 'one' ],[ 2, 'two' ]]）。每一個鍵值對都會被加入至新的 Map；null 會被視為 undefined。
+
+ +

描述

+ +

一個 Map 物件會根據元素的新增順序走訪自身的所有元素 — {{jsxref("Statements/for...of", "for...of")}} 迴圈會在每次迭代回傳一個 [key, value] 陣列。

+ + + +

鍵的相等性

+ +

鍵相等是基於 SameValueZero 的演算法：NaN 被認為與 NaN 相同（即使 NaN !== NaN）並且根據 === 運算符的語義，所有其他值都被認為相等。在目前的ECMAScript 規範中，-0 和 +0 被認為是相等的，儘管在早期的草案中並非如此。詳細的內容請參閱 {{anch("Browser compatibility")}} 表中的 "Value equality for -0 and 0"。

+ +

Object 及 Map 的比較

+ +

{{jsxref("Object")}} 和 Map 類似。兩者都允許你設置對應的鍵值對，檢索這些值，刪除鍵，並檢測是否有什麼存儲在鍵中。正因為如此（也因為沒有內置的替代品），Object 在歷史上一直被當作 Map 使用；然而在某些情況下，使用 Map 有一些重要的不同之處:

+ + + +

屬性

+ +
+
Map.length
+
length屬性的值為 0
+ 要計算 Map 中有多少元素，可以使用 {{jsxref("Map.prototype.size")}}。
+
{{jsxref("Map.@@species", "get Map[@@species]")}}
+
用於創建派生物件的構造函數。
+
{{jsxref("Map.prototype")}}
+
表示 Map 構造函數的原型，允許對所有的 Map 物件添加屬性
+
+ +

Map 物件實體

+ +

所有的 Map 實例都繼承自 {{jsxref("Map.prototype")}}.

+ +

屬性

+ +

{{page('zh-TW/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

+ +

方法

+ +

{{page('zh-TW/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

+ +

範例

+ +

使用 Map 物件

+ +
var myMap = new Map();
+
+var keyString = 'a string',
+    keyObj = {},
+    keyFunc = function() {};
+
+// setting the values
+myMap.set(keyString, "value associated with 'a string'");
+myMap.set(keyObj, 'value associated with keyObj');
+myMap.set(keyFunc, 'value associated with keyFunc');
+
+myMap.size; // 3
+
+// getting the values
+myMap.get(keyString);    // "value associated with 'a string'"
+myMap.get(keyObj);       // "value associated with keyObj"
+myMap.get(keyFunc);      // "value associated with keyFunc"
+
+myMap.get('a string');   // "value associated with 'a string'"
+                         // because keyString === 'a string'
+myMap.get({});           // undefined, because keyObj !== {}
+myMap.get(function() {}) // undefined, because keyFunc !== function () {}
+
+ +

使用 NaN 作為 Map 的鍵

+ +

NaN 同樣可以作為 Map 的 key，雖然每個 NaN 都不等於自己本身，下面的例子是有效的，因為 NaN 無法區分彼此。

+ +
var myMap = new Map();
+myMap.set(NaN, 'not a number');
+
+myMap.get(NaN); // "not a number"
+
+var otherNaN = Number('foo');
+myMap.get(otherNaN); // "not a number"
+
+ +

透過 for..of 迭代 Map

+ +

Map 可以使用 for..of 迴圈進行迭代：

+ +
var myMap = new Map();
+myMap.set(0, 'zero');
+myMap.set(1, 'one');
+for (var [key, value] of myMap) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+for (var key of myMap.keys()) {
+  console.log(key);
+}
+// 0
+// 1
+
+for (var value of myMap.values()) {
+  console.log(value);
+}
+// zero
+// one
+
+for (var [key, value] of myMap.entries()) {
+  console.log(key + ' = ' + value);
+}
+// 0 = zero
+// 1 = one
+
+ +

透過 forEach() 迭代 Map

+ +

Map 可以使用 forEach() 方法進行迭代：

+ +
myMap.forEach(function(value, key) {
+  console.log(key + ' = ' + value);
+});
+// Will show 2 logs; first with "0 = zero" and second with "1 = one"
+
+ +

與 Array 物件關聯

+ +
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
+
+// Use the regular Map constructor to transform a 2D key-value Array into a map
+var myMap = new Map(kvArray);
+
+myMap.get('key1'); // returns "value1"
+
+// Use the Array.from function to transform a map into a 2D key-value Array
+console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray
+
+// Or use the keys or values iterators and convert them to an array
+console.log(Array.from(myMap.keys())); // Will show ["key1", "key2"]
+
+ + + +

 複製與合併 Map

+ +

就像 Array 一樣，Map 可以被複製:

+ +
var original = new Map([
+  [1, 'one']
+]);
+
+var clone = new Map(original);
+
+console.log(clone.get(1)); // one
+console.log(original === clone); // false. Useful for shallow comparison
+ +

請記住，數據本身並非克隆的。

+ +

Map 可以被合併，保持鍵的唯一性:

+ +
var first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+var second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// Merge two maps. The last repeated key wins.
+// Spread operator essentially converts a Map to an Array
+var merged = new Map([...first, ...second]);
+
+console.log(merged.get(1)); // uno
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+ +

Map 也可以跟 Array 合併：

+ +
var first = new Map([
+  [1, 'one'],
+  [2, 'two'],
+  [3, 'three'],
+]);
+
+var second = new Map([
+  [1, 'uno'],
+  [2, 'dos']
+]);
+
+// Merge maps with an array. The last repeated key wins.
+var merged = new Map([...first, ...second, [1, 'eins']]);
+
+console.log(merged.get(1)); // eins
+console.log(merged.get(2)); // dos
+console.log(merged.get(3)); // three
+
+ +

規範

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
+ +

瀏覽器相容性

+ + + +

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

+ +

參見

+ + diff --git a/files/zh-tw/web/javascript/reference/global_objects/map/index.html b/files/zh-tw/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 07dc862188..0000000000 --- a/files/zh-tw/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,265 +0,0 @@ ---- -title: Map -slug: Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map ---- -
{{JSRef}}
- -

Map 是保存了鍵值對（key-value pairs）的物件。任何值（包括物件及{{Glossary("Primitive", "基本型別（primitive）值")}}）都可以作為鍵或值。

- -

語法

- -
new Map([iterable])
- -

參數

- -
-
iterable
-
為一個{{jsxref("Array", "陣列")}}或其他元素成鍵值對的可迭代物件（有兩個元素的陣列，例如 [[ 1, 'one' ],[ 2, 'two' ]]）。每一個鍵值對都會被加入至新的 Map；null 會被視為 undefined。
-
- -

描述

- -

一個 Map 物件會根據元素的新增順序走訪自身的所有元素 — {{jsxref("Statements/for...of", "for...of")}} 迴圈會在每次迭代回傳一個 [key, value] 陣列。

- - - -

鍵的相等性

- -

鍵相等是基於 SameValueZero 的演算法：NaN 被認為與 NaN 相同（即使 NaN !== NaN）並且根據 === 運算符的語義，所有其他值都被認為相等。在目前的ECMAScript 規範中，-0 和 +0 被認為是相等的，儘管在早期的草案中並非如此。詳細的內容請參閱 {{anch("Browser compatibility")}} 表中的 "Value equality for -0 and 0"。

- -

Object 及 Map 的比較

- -

{{jsxref("Object")}} 和 Map 類似。兩者都允許你設置對應的鍵值對，檢索這些值，刪除鍵，並檢測是否有什麼存儲在鍵中。正因為如此（也因為沒有內置的替代品），Object 在歷史上一直被當作 Map 使用；然而在某些情況下，使用 Map 有一些重要的不同之處:

- - - -

屬性

- -
-
Map.length
-
length屬性的值為 0
- 要計算 Map 中有多少元素，可以使用 {{jsxref("Map.prototype.size")}}。
-
{{jsxref("Map.@@species", "get Map[@@species]")}}
-
用於創建派生物件的構造函數。
-
{{jsxref("Map.prototype")}}
-
表示 Map 構造函數的原型，允許對所有的 Map 物件添加屬性
-
- -

Map 物件實體

- -

所有的 Map 實例都繼承自 {{jsxref("Map.prototype")}}.

- -

屬性

- -

{{page('zh-TW/Web/JavaScript/Reference/Global_Objects/Map/prototype','Properties')}}

- -

方法

- -

{{page('zh-TW/Web/JavaScript/Reference/Global_Objects/Map/prototype','Methods')}}

- -

範例

- -

使用 Map 物件

- -
var myMap = new Map();
-
-var keyString = 'a string',
-    keyObj = {},
-    keyFunc = function() {};
-
-// setting the values
-myMap.set(keyString, "value associated with 'a string'");
-myMap.set(keyObj, 'value associated with keyObj');
-myMap.set(keyFunc, 'value associated with keyFunc');
-
-myMap.size; // 3
-
-// getting the values
-myMap.get(keyString);    // "value associated with 'a string'"
-myMap.get(keyObj);       // "value associated with keyObj"
-myMap.get(keyFunc);      // "value associated with keyFunc"
-
-myMap.get('a string');   // "value associated with 'a string'"
-                         // because keyString === 'a string'
-myMap.get({});           // undefined, because keyObj !== {}
-myMap.get(function() {}) // undefined, because keyFunc !== function () {}
-
- -

使用 NaN 作為 Map 的鍵

- -

NaN 同樣可以作為 Map 的 key，雖然每個 NaN 都不等於自己本身，下面的例子是有效的，因為 NaN 無法區分彼此。

- -
var myMap = new Map();
-myMap.set(NaN, 'not a number');
-
-myMap.get(NaN); // "not a number"
-
-var otherNaN = Number('foo');
-myMap.get(otherNaN); // "not a number"
-
- -

透過 for..of 迭代 Map

- -

Map 可以使用 for..of 迴圈進行迭代：

- -
var myMap = new Map();
-myMap.set(0, 'zero');
-myMap.set(1, 'one');
-for (var [key, value] of myMap) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
-for (var key of myMap.keys()) {
-  console.log(key);
-}
-// 0
-// 1
-
-for (var value of myMap.values()) {
-  console.log(value);
-}
-// zero
-// one
-
-for (var [key, value] of myMap.entries()) {
-  console.log(key + ' = ' + value);
-}
-// 0 = zero
-// 1 = one
-
- -

透過 forEach() 迭代 Map

- -

Map 可以使用 forEach() 方法進行迭代：

- -
myMap.forEach(function(value, key) {
-  console.log(key + ' = ' + value);
-});
-// Will show 2 logs; first with "0 = zero" and second with "1 = one"
-
- -

與 Array 物件關聯

- -
var kvArray = [['key1', 'value1'], ['key2', 'value2']];
-
-// Use the regular Map constructor to transform a 2D key-value Array into a map
-var myMap = new Map(kvArray);
-
-myMap.get('key1'); // returns "value1"
-
-// Use the Array.from function to transform a map into a 2D key-value Array
-console.log(Array.from(myMap)); // Will show you exactly the same Array as kvArray
-
-// Or use the keys or values iterators and convert them to an array
-console.log(Array.from(myMap.keys())); // Will show ["key1", "key2"]
-
- - - -

 複製與合併 Map

- -

就像 Array 一樣，Map 可以被複製:

- -
var original = new Map([
-  [1, 'one']
-]);
-
-var clone = new Map(original);
-
-console.log(clone.get(1)); // one
-console.log(original === clone); // false. Useful for shallow comparison
- -

請記住，數據本身並非克隆的。

- -

Map 可以被合併，保持鍵的唯一性:

- -
var first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-var second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// Merge two maps. The last repeated key wins.
-// Spread operator essentially converts a Map to an Array
-var merged = new Map([...first, ...second]);
-
-console.log(merged.get(1)); // uno
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
- -

Map 也可以跟 Array 合併：

- -
var first = new Map([
-  [1, 'one'],
-  [2, 'two'],
-  [3, 'three'],
-]);
-
-var second = new Map([
-  [1, 'uno'],
-  [2, 'dos']
-]);
-
-// Merge maps with an array. The last repeated key wins.
-var merged = new Map([...first, ...second, [1, 'eins']]);
-
-console.log(merged.get(1)); // eins
-console.log(merged.get(2)); // dos
-console.log(merged.get(3)); // three
-
- -

規範

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-map-objects', 'Map')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}{{Spec2('ESDraft')}}
- -

瀏覽器相容性

- - - -

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

- -

參見

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