Map 対応: ES6（ECMAScript 2015）

キーと値のペアを管理するコレクションです。オブジェクトと異なり、あらゆるデータ型をキーとして使用でき、挿入順序が保持されます。

構文

// 新しいMapを作成します。
var map = new Map();

// 初期値を指定して作成することもできます。
var map = new Map([
	["キー1", "値1"],
	["キー2", "値2"]
]);

メソッド・プロパティ一覧

メソッド / プロパティ	概要
set(キー, 値)	キーと値のペアを追加します。同じキーがすでに存在する場合は値が上書きされます。
get(キー)	指定したキーの値を取得します。キーが存在しない場合は『undefined』を返します。
has(キー)	指定したキーが存在するかどうかを『true』または『false』で返します。
delete(キー)	指定したキーのペアを削除します。削除に成功した場合は『true』、キーが存在しなかった場合は『false』を返します。
clear()	すべてのペアを削除します。
size	格納されているペアの数を返します。
forEach(関数)	すべてのペアに対して関数を実行します。コールバック関数の引数は『値, キー, Map本体』の順番です。

サンプルコード

// Mapの基本操作
var userMap = new Map();

// データを追加します。
userMap.set("name", "太郎");
userMap.set("age", 25);
userMap.set("active", true);

// データを取得します。
console.log(userMap.get("name")); // 『太郎』と出力されます。
console.log(userMap.get("age")); // 『25』と出力されます。

// キーの存在を確認します。
console.log(userMap.has("name")); // 『true』と出力されます。
console.log(userMap.has("email")); // 『false』と出力されます。

// 件数を確認します。
console.log(userMap.size); // 『3』と出力されます。

// すべてのペアを順番に処理します。
userMap.forEach(function(value, key) {
	console.log(key + ": " + value);
});

// オブジェクトをキーとして使う例
var key1 = { id: 1 };
var key2 = { id: 2 };
var objMap = new Map();
objMap.set(key1, "ユーザー1");
objMap.set(key2, "ユーザー2");
console.log(objMap.get(key1)); // 『ユーザー1』と出力されます。

// データを削除します。
userMap.delete("active");
console.log(userMap.size); // 『2』と出力されます。

// すべてのデータを削除します。
userMap.clear();
console.log(userMap.size); // 『0』と出力されます。

Mapとオブジェクトの違い

特徴	Map	オブジェクト
キーの型	あらゆるデータ型が使えます。	文字列とSymbolのみです。
挿入順序	保持されます。	保持されますが、数値キーは先にソートされます。
件数の取得	『size』プロパティで取得できます。	『Object.keys(obj).length』で計算する必要があります。
繰り返し処理	『forEach()』や『for...of』で直接走査できます。	『Object.keys()』等で変換が必要です。