Map 对象保存键值对，并且能够记住键的原始插入顺序。
任何值(对象或者原始值) 都可以作为一个键或一个值。
Map 是 ES6 中引入的一种新的数据结构，可以参考 ES6 Map 与 Set。
TypeScript 使用 Map 类型和 new 关键字来创建 Map：
|
1 |
let myMap = new Map(); |
初始化 Map，可以以数组的格式来传入键值对：
|
1 2 3 4 |
let myMap = new Map([ ["key1", "value1"], ["key2", "value2"] ]); |
Map 相关的函数与属性：
set(key: K, value: V): this – 向 Map 中添加或更新键值对。
|
1 |
map.set('key1', 'value1'); |
get(key: K): V | undefined – 根据键获取值，如果键不存在则返回 undefined。
|
1 |
const value = map.get('key1'); |
has(key: K): boolean – 检查 Map 中是否存在指定的键。
|
1 |
const exists = map.has('key1'); |
delete(key: K): boolean – 删除指定键的键值对，成功删除返回 true，否则返回 false。
|
1 |
const removed = map.delete('key1'); |
clear(): void – 清空 Map 中的所有键值对。
|
1 |
map.clear(); |
size: number – 返回 Map 中键值对的数量。
|
1 |
const size = map.size; |
keys(): IterableIterator<K> – 返回一个包含 Map 中所有键的迭代器。
|
1 2 3 |
for (const key of map.keys()) { console.log(key); } |
values(): IterableIterator<V> – 返回一个包含 Map 中所有值的迭代器。
|
1 2 3 |
for (const value of map.values()) { console.log(value); } |
entries(): IterableIterator<[K, V]> – 返回一个包含 Map 中所有键值对的迭代器，每个元素是一个 [key, value] 数组。
|
1 2 3 |
for (const [key, value] of map.entries()) { console.log(key, value); } |
forEach(callbackfn: (value: V, key: K, map: Map<K, V>) => void, thisArg?: any): void – 对 Map 中的每个键值对执行一次提供的回调函数。
|
1 2 3 |
map.forEach((value, key) => { console.log(key, value); }); |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
const map = new Map<string, number>(); map.set('one', 1); map.set('two', 2); console.log(map.get('one')); // 输出: 1 console.log(map.has('two')); // 输出: true map.delete('one'); console.log(map.size); // 输出: 1 map.forEach((value, key) => { console.log(key, value); // 输出: two 2 }); map.clear(); console.log(map.size); // 输出: 0 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
let nameSiteMapping = new Map(); // 设置 Map 对象 nameSiteMapping.set("Google", 1); nameSiteMapping.set("Runoob", 2); nameSiteMapping.set("Taobao", 3); // 获取键对应的值 console.log(nameSiteMapping.get("Runoob")); // 2 // 判断 Map 中是否包含键对应的值 console.log(nameSiteMapping.has("Taobao")); // true console.log(nameSiteMapping.has("Zhihu")); // false // 返回 Map 对象键/值对的数量 console.log(nameSiteMapping.size); // 3 // 删除 Runoob console.log(nameSiteMapping.delete("Runoob")); // true console.log(nameSiteMapping); // 移除 Map 对象的所有键/值对 nameSiteMapping.clear(); // 清除 Map console.log(nameSiteMapping); |
使用 es6 编译：
|
1 |
tsc --target es6 test.ts |
编译以上代码得到如下 JavaScript 代码：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
let nameSiteMapping = new Map(); // 设置 Map 对象 nameSiteMapping.set("Google", 1); nameSiteMapping.set("Runoob", 2); nameSiteMapping.set("Taobao", 3); // 获取键对应的值 console.log(nameSiteMapping.get("Runoob")); //40 // 判断 Map 中是否包含键对应的值 console.log(nameSiteMapping.has("Taobao")); //true console.log(nameSiteMapping.has("Zhihu")); //false // 返回 Map 对象键/值对的数量 console.log(nameSiteMapping.size); //3 // 删除 Runoob console.log(nameSiteMapping.delete("Runoob")); // true console.log(nameSiteMapping); // 移除 Map 对象的所有键/值对 nameSiteMapping.clear(); //清除 Map console.log(nameSiteMapping); |
执行以上 JavaScript 代码，输出结果为：
|
1 2 3 4 5 6 7 |
2 true false 3 true Map { 'Google' => 1, 'Taobao' => 3 } Map {} |
Map 对象中的元素是按顺序插入的，我们可以迭代 Map 对象，每一次迭代返回 [key, value] 数组。
TypeScript使用 for…of 来实现迭代：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
let nameSiteMapping = new Map(); nameSiteMapping.set("Google", 1); nameSiteMapping.set("Runoob", 2); nameSiteMapping.set("Taobao", 3); // 迭代 Map 中的 key for (let key of nameSiteMapping.keys()) { console.log(key); } // 迭代 Map 中的 value for (let value of nameSiteMapping.values()) { console.log(value); } // 迭代 Map 中的 key => value for (let entry of nameSiteMapping.entries()) { console.log(entry[0], entry[1]); } // 使用对象解析 for (let [key, value] of nameSiteMapping) { console.log(key, value); } |
使用 es6 编译：
|
1 |
tsc --target es6 test.ts |
编译以上代码得到如下 JavaScript 代码：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
let nameSiteMapping = new Map(); nameSiteMapping.set("Google", 1); nameSiteMapping.set("Runoob", 2); nameSiteMapping.set("Taobao", 3); // 迭代 Map 中的 key for (let key of nameSiteMapping.keys()) { console.log(key); } // 迭代 Map 中的 value for (let value of nameSiteMapping.values()) { console.log(value); } // 迭代 Map 中的 key => value for (let entry of nameSiteMapping.entries()) { console.log(entry[0], entry[1]); } // 使用对象解析 for (let [key, value] of nameSiteMapping) { console.log(key, value); } |
执行以上 JavaScript 代码，输出结果为：
|
1 2 3 4 5 6 7 8 9 10 11 12 |
Google Runoob Taobao 1 2 3 Google 1 Runoob 2 Taobao 3 Google 1 Runoob 2 Taobao 3 |
from: https://www.runoob.com/typescript/ts-map.html