含義和基本用法

　 Map對象就是簡單的鍵值對映射。其中的鍵和值可以使任意值。（ps : 對象的鍵只能是字符串 ）

　JavaScript 的對象（Object），本質上是鍵值對的集合（Hash 結構），但是傳統上只能用字符串當作鍵。這給它的使用帶來了很大的限制。

const data = {};
const element = document.getElementById(‘myDiv‘);

data[element] = ‘metadata‘;
data[‘[object HTMLDivElement]‘] // "metadata"

上面代碼原意是將一個 DOM 節點作為對象data

為了解決這個問題，ES6 提供了 Map 數據結構。它類似於對象，也是鍵值對的集合，但是“鍵”的範圍不限於字符串，各種類型的值（包括對象）都可以當作鍵。也就是說，Object 結構提供了“字符串—值”的對應，Map 結構提供了“值—值”的對應，是一種更完善的 Hash 結構實現。如果你需要“鍵值對”的數據結構，Map 比 Object 更合適。

const m = new Map();
const o = {p: ‘Hello World‘};

m.set(o, 
 
‘content‘)
m.get(o) // "content"

m.has(o) // true
m.delete(o) // true
m.has(o) // false

使用 Map 結構的set方法，將對象o當作m的一個鍵，然後又使用get方法讀取這個鍵，接著使用delete方法刪除了這個鍵。

實例的屬性和操作方法

　　Map 結構的實例有以下屬性和操作方法。

　　（1）size 屬性

size屬性返回 Map 結構的成員總數。

const map = new Map();
map.set(‘foo‘, true);
map.set(‘bar‘, false);

map.size // 2

（2）set(key, value)

set方法設置鍵名key對應的鍵值為value，然後返回整個 Map 結構。如果key已經有值，則鍵值會被更新，否則就新生成該鍵。

const m = new Map();

m.set(‘edition‘, 6)        // 鍵是字符串
m.set(262, ‘standard‘)     // 鍵是數值
m.set(undefined, ‘nah‘)    // 鍵是 undefined

set方法返回的是當前的Map對象，因此可以采用鏈式寫法。

let map = new Map()
  .set(1, ‘a‘)
  .set(2, ‘b‘)
  .set(3, ‘c‘);

（3）get(key)

get方法讀取key對應的鍵值，如果找不到key，返回undefined。

const m = new Map();

const hello = function() {console.log(‘hello‘);};
m.set(hello, ‘Hello ES6!‘) // 鍵是函數

m.get(hello)  // Hello ES6!

（4）has(key)

has方法返回一個布爾值，表示某個鍵是否在當前 Map 對象之中。

const m = new Map();

m.set(‘edition‘, 6);
m.set(262, ‘standard‘);
m.set(undefined, ‘nah‘);

m.has(‘edition‘)     // true
m.has(‘years‘)       // false
m.has(262)           // true
m.has(undefined)     // true

（5）delete(key)

delete方法刪除某個鍵，返回true。如果刪除失敗，返回false。

const m = new Map();
m.set(undefined, ‘nah‘);
m.has(undefined)     // true

m.delete(undefined)
m.has(undefined)       // false

（6）clear()

clear方法清除所有成員，沒有返回值。

let map = new Map();
map.set(‘foo‘, true);
map.set(‘bar‘, false);

map.size // 2
map.clear()
map.size // 0

遍歷方法

Map 結構原生提供三個遍歷器生成函數和一個遍歷方法。

• keys()：返回鍵名的遍歷器。
• values()：返回鍵值的遍歷器。
• entries()：返回所有成員的遍歷器。
• forEach()：遍歷 Map 的所有成員。

需要特別註意的是，Map 的遍歷順序就是插入順序。

const map = new Map([
  [‘F‘, ‘no‘],
  [‘T‘,  ‘yes‘],
]);

for (let key of map.keys()) {
  console.log(key);
}
// "F"
// "T"

for (let value of map.values()) {
  console.log(value);
}
// "no"
// "yes"

for (let item of map.entries()) {
  console.log(item[0], item[1]);
}
// "F" "no"
// "T" "yes"

// 或者
for (let [key, value] of map.entries()) {
  console.log(key, value);
}
// "F" "no"
// "T" "yes"

// 等同於使用map.entries()
for (let [key, value] of map) {
  console.log(key, value);
}
// "F" "no"
// "T" "yes"

上面代碼最後的那個例子，表示 Map 結構的默認遍歷器接口（Symbol.iterator屬性），就是entries方法。

map[Symbol.iterator] === map.entries
// true

與其他數據結構的互相轉換

（1）Map 轉為數組

前面已經提過，Map 轉為數組最方便的方法，就是使用擴展運算符（...）。

const myMap = new Map()
  .set(true, 7)
  .set({foo: 3}, [‘abc‘]);
[...myMap]
// [ [ true, 7 ], [ { foo: 3 }, [ ‘abc‘ ] ] ]

（2）數組 轉為 Map

將數組傳入 Map 構造函數，就可以轉為 Map。

new Map([
  [true, 7],
  [{foo: 3}, [‘abc‘]]
])
// Map {
//   true => 7,
//   Object {foo: 3} => [‘abc‘]
// }

（3）Map 轉為對象

如果所有 Map 的鍵都是字符串，它可以無損地轉為對象。

function strMapToObj(strMap) {
  let obj = Object.create(null);
  for (let [k,v] of strMap) {
    obj[k] = v;
  }
  return obj;
}

const myMap = new Map()
  .set(‘yes‘, true)
  .set(‘no‘, false);
strMapToObj(myMap)
// { yes: true, no: false }

如果有非字符串的鍵名，那麽這個鍵名會被轉成字符串，再作為對象的鍵名。

（4）對象轉為 Map

function objToStrMap(obj) {
  let strMap = new Map();
  for (let k of Object.keys(obj)) {
    strMap.set(k, obj[k]);
  }
  return strMap;
}

objToStrMap({yes: true, no: false})
// Map {"yes" => true, "no" => false}

（5）Map 轉為 JSON

Map 轉為 JSON 要區分兩種情況。一種情況是，Map 的鍵名都是字符串，這時可以選擇轉為對象 JSON。

function strMapToJson(strMap) {
  return JSON.stringify(strMapToObj(strMap));
}

let myMap = new Map().set(‘yes‘, true).set(‘no‘, false);
strMapToJson(myMap)
// ‘{"yes":true,"no":false}‘

另一種情況是，Map 的鍵名有非字符串，這時可以選擇轉為數組 JSON。

function mapToArrayJson(map) {
  return JSON.stringify([...map]);
}

let myMap = new Map().set(true, 7).set({foo: 3}, [‘abc‘]);
mapToArrayJson(myMap)
// ‘[[true,7],[{"foo":3},["abc"]]]‘

（6）JSON 轉為 Map

JSON 轉為 Map，正常情況下，所有鍵名都是字符串。

function jsonToStrMap(jsonStr) {
  return objToStrMap(JSON.parse(jsonStr));
}

jsonToStrMap(‘{"yes": true, "no": false}‘)
// Map {‘yes‘ => true, ‘no‘ => false}

但是，有一種特殊情況，整個 JSON 就是一個數組，且每個數組成員本身，又是一個有兩個成員的數組。這時，它可以一一對應地轉為 Map。這往往是 Map 轉為數組 JSON 的逆操作。

function jsonToMap(jsonStr) {
  return new Map(JSON.parse(jsonStr));
}

jsonToMap(‘[[true,7],[{"foo":3},["abc"]]]‘)
// Map {true => 7, Object {foo: 3} => [‘abc‘]}

創建Map實例的兩種方法

    //第一種方法：
    var map = new Map();
    map.set(‘one‘, 1);
    map.set(‘two‘, 2);
    map.set(‘three‘, 3);
    //...    

    //第二種方法：
    var map = new Map([[‘one‘,1], [‘two‘, 2], [‘three‘, 3]]);

鍵的比較

鍵的比較規則：NaN 是與NaN是相同的（雖然NaN !== NaN）,除此之外所有的值都根據‘===‘判斷。

    var map = new Map();
    map.set(Number(‘aa111‘), ‘isNaN‘);
    map.set(Number(‘bb222‘), ‘also is NaN‘);
    map.get(NaN);    //‘also is NaN‘

Map VS Object

• 一個對象通常都有自己的原型，所以一個對象總有一個"prototype"鍵。不過，從ES5開始可以使用map = Object.create(null)來創建一個沒有原型的對象。

• 一個對象的鍵只能是字符串或者Symbols，但一個Map的鍵可以是任意值。

• 你可以通過size屬性很容易地得到一個Map的鍵值對個數，而對象的鍵值對個數只能手動確認。

Map屬性

• Map.length 屬性length的值為0。

• Map.prototype 表示Map構造器的原型。允許添加屬性從而應用與所有的Map對象。

Map實例 - 所有Map對象的實例都會繼承Map.prototype。

屬性

• Map.prototype.constructor 返回創建給map實例的構造函數，默認是Map函數。

• Map.prototype.size 返回Map對象的鍵值對的數量。

    var map = new Map([[‘one‘,1], [‘two‘, 2], [‘three‘, 3]]);
    console.log(map.constructor); //function Map() { [native code] }
    console.log(map.size); //3

方法小結：

    //Iterator對象：可以使用for..of進行叠代的對象
    var map = new Map([[1, ‘one‘],[2, ‘two‘], [3, ‘three‘]]);

（1）Map.prototype.clear() 移除Map對象的所有鍵值對。==》map.clear();

（2）Map.prototype.delete(key) 移除任何與鍵相關聯的值，並且返回該值，該值在之前會被Map.prototype.has(key)返回為true。之後再調用則返回false。==》map.delete(1);

（3）Map.prototype.entries() 返回一個新的Iterator對象，它按插入順序包含了Map對象中每個元素的[key, value]數組。==》map.entries();

（4）Map.prototype.forEach(callbackFn[, thisArg]) 按插入順序，為Map對象裏的每一鍵值對調用一次callbackFn函數。如果為forEach提供了thisArg，他將在每次回調函數中作為this值。

    map.forEach(function(value, key, mapObj) {
        console.log(value + ‘---‘ + key + ‘---‘ + mapObj);
        //value - Map對象裏每一個鍵值對的值
        //key - Map對象裏每一個鍵值對的鍵
        //mapObj - Map對象本身
        console.log(this); //this === window
    });

    map.forEach(function(value, key, mapObj) {
        console.log(value + ‘---‘ + key + ‘---‘ + mapObj);
        console.log(this);    //this === map
    }, map)

（5）Map.prototype.get(key) 返回鍵對應的值，如果不存在，則返回undefined。==》map.get(1); //‘one‘

（6）Map.prototype.has(key) 返回一個布爾值，表示Map實例是否包含鍵對應的值。==》map.has(1); // true

（7）Map.prototype.keys() 返回一個新的Iterator對象，它按插入順序包含了Map對象中每個元素的鍵。==》map.keys(); //MapIterator {1, 2, 3}

（8）Map.prototype.set(key, value) 設置Map對象中鍵的值，返回該Map對象。==》map.set(4, ‘four‘);

（9）Map.prototype.values() 返回一個新的Iterator對象，它按插入順序包含了Map對象中每個元素的值。==》map.values();

使用for..of方法叠代映射

    var map = new Map();
    map.set(1, ‘one‘);
    map.set(2, ‘two‘);
    for (var [key, value] of map) {
        console.log(key + ‘---‘ + value);
    }
    // 1 --- one 2 --- two
    
    for (var key of map.keys()) {
        console.log(key);
    }
    // 1 2
    
    for (var value of map.values()) {
        console.log(value);
    }
    // ‘one‘ ‘two‘

ES6 - Map