JavaScript Map集合怎么取值?get方法与遍历技巧
详细讲解JavaScript中Map集合如何通过get方法精准取值、引用类型键与NaN的匹配规则,以及for...of、forEach、keys、values、entries等遍历与转换技巧。
很多开发者刚接触 Map 时,会习惯性地写下 map['name'] 或 map.name 来读取数据,结果控制台打印出 undefined,哪怕刚刚才用 set() 存进去且 console.log(map) 里明明看得到这个键。出现这个现象的原因很直接:Map 的键值对存放在内部条目表中,而不是对象的普通属性上。要读取单个键的值,必须调用 map.get(key);要批量读取全部或部分数据,则要配合 for...of、forEach() 以及 keys()、values()、entries() 等迭代器方法。
一、用 get() 方法按键取值:基础用法与匹配规则
从 Map 中根据已知键读取值,标准方法只有 map.get(key)。你可以在浏览器开发者工具的 Console 面板或 Node.js 环境中直接运行下面这段代码观察它的行为:
// 运行环境:浏览器 Console 或 Node.js
const userMap = new Map();
userMap.set('name', '林远');
userMap.set(1001, '普通会员');
console.log(userMap.get('name'));
console.log(userMap.get(1001));
console.log(userMap.get('1001'));
console.log(userMap.get('age'));
注意上面第三行输出:数字 1001 和字符串 '1001' 在 Map 中是两个完全不同的键。普通对象会把所有属性名自动转为字符串,而 Map 不会做这种隐式转换,因此用 get('1001') 找不到以数字 1001 存入的记录。
1. 当键不存在或值本身是 undefined 时怎么区分
如果键不存在,get() 返回 undefined;但如果某个键对应的值本身就是 undefined,get() 同样返回 undefined。在需要区分“没存这个键”和“值就是 undefined”的场景下,应先用 map.has(key) 判断键是否存在:
const config = new Map([['timeout', undefined]]);
console.log(config.get('timeout'));
console.log(config.has('timeout'));
console.log(config.has('retry'));
2. 对象作为键时为什么常取不到值
Map 允许把对象、数组、函数甚至 NaN 当作键,底层使用 SameValueZero 算法判定两个键是否相等。这个规则有两个实际影响需要特别留意:
- 对象和数组按引用地址比对:即使两个对象内容一模一样,只要不是同一个引用,
get()就认为它们不是同一个键。 - 特殊基本类型的匹配:
NaN与NaN会被判定为相等(这与===返回false不同);+0和-0也被视作同一个键。
const cache = new Map();
const keyObj = { id: 1 };
cache.set(keyObj, '用户详情');
cache.set(NaN, '非数字标记');
// 使用同一个对象引用可以取到值
console.log(cache.get(keyObj));
// 新建一个内容相同但引用不同的对象,取不到值
console.log(cache.get({ id: 1 }));
// NaN 可以正常匹配
console.log(cache.get(NaN));
Map 本质上也是一个 JavaScript 对象,因此语法上允许你写 cache['role'] = 'admin',但这种写法只是在 cache 实例上挂了一个普通对象属性,并没有放进 Map 的内部集合里。结果就是 cache.size 不会增加,cache.get('role') 依然返回 undefined,所有遍历方法也看不到它。
二、批量取值:四种遍历技巧与适用区别
当需要把整个 Map 里的内容全部取出来,或者在遍历过程中按条件查找目标值时,不能依赖索引下标(Map 没有 map[0] 这种索引)。好在 ECMAScript 规范保证 Map 严格按照元素插入的顺序保存条目,并且原生支持迭代协议。日常开发主要用到下面四种方式。
1. for...of 直接解构(最常用的默认方式)
对 Map 实例直接使用 for...of 时,默认等价于遍历 map.entries(),每次迭代产出一个 [key, value] 二元数组。配合数组解构可以直接拿到键和值,更重要的是它支持用 break 提前结束循环,或者用 continue 跳过当前项。
const scores = new Map([
['语文', 88],
['数学', 95],
['英语', 91]
]);
for (const [subject, score] of scores) {
if (score >= 95) {
console.log(`找到高分科目:${subject} (${score})`);
break;
}
}
2. forEach() 回调遍历(注意参数顺序反转)
map.forEach(callback) 的写法和数组的 forEach 相似,但有一个非常容易写反的细节:回调函数的参数顺序是 (value, key, map)——值在第一个参数,键在第二个参数,恰好与 for...of 里的 [key, value] 相反。另外,forEach 内部无法通过 break 中断循环,return 也只能结束当前这一次回调。
const prices = new Map([
['苹果', 6.5],
['香蕉', 4.0]
]);
// 注意:第一个参数是 value,第二个参数才是 key
prices.forEach((price, fruit) => {
console.log(`${fruit} 单价:${price} 元`);
});
3. 只取键或只取值:keys() 与 values()
如果明确不需要另一半数据,调用 map.keys() 或 map.values() 可以避免多余的解构。这两个方法返回的不是普通数组,而是一个 MapIterator(迭代器对象),可以直接放进 for...of 循环中按需消耗,几乎不额外占用内存。
const stock = new Map([
['键盘', 12],
['鼠标', 35],
['显示器', 8]
]);
let totalCount = 0;
for (const count of stock.values()) {
totalCount += count;
}
console.log('库存总件数:', totalCount);
4. 显式获取键值对迭代器:entries()
map.entries() 返回包含所有 [key, value] 对的迭代器,行为与直接遍历 map 本身一致。当代码需要清晰表达“这里正在取键值对”,或者要把迭代器传给接收可迭代对象的工具函数时,显式写出 .entries() 可读性更好。
三、实用取值与转换技巧
了解基本语法之后,实际写业务代码时还会遇到“键不存在给默认值”、“按条件过滤 Map 里的条目”以及“转成数组或普通对象”等高频需求。结合下面几个技巧可以写得更稳妥。
1. 用空值合并运算符(??)安全设置默认值
以前很多代码习惯用 map.get(key) || defaultValue 提供默认值,但这在存储数字 0、布尔值 false 或空字符串 '' 时会出错——逻辑或 || 会把这些合法的“假值”也当成没取到而替换成默认值。改用 ??(空值合并运算符)只会在结果为 null 或 undefined 时才回退到默认值:
const retryCount = new Map([['upload', 0]]);
// 错误示范:|| 会把 0 当成假值覆盖为 3
console.log(retryCount.get('upload') || 3);
// 推荐写法:?? 只在 undefined / null 时启用默认值
console.log(retryCount.get('upload') ?? 3);
console.log(retryCount.get('download') ?? 3);
2. 转为数组后使用 filter、map、sort
Map 实例自身没有 filter()、sort() 方法。需要按值筛选或排序时,可以先用扩展运算符 [...map] 或 Array.from(map) 把它转成二维数组,处理完再按需要重新包回 new Map(...):
const tasks = new Map([
['t1', { title: '接口联调', done: true }],
['t2', { title: '补充单测', done: false }],
['t3', { title: '上线检查', done: false }]
]);
// 筛选未完成的任务,并提取标题数组
const pendingTitles = [...tasks.values()]
.filter((item) => !item.done)
.map((item) => item.title);
console.log(pendingTitles);
3. Map 与普通对象的互转边界
需要与只接受普通对象的接口对接时,可以用 Object.fromEntries(map) 把 Map 转为普通对象;反过来则用 new Map(Object.entries(obj))。但要注意:Object.fromEntries 会把非字符串、非 Symbol 的键自动转为字符串,如果原 Map 里有对象键或数字键,转换后键的原始类型会丢失(对象键会变成 "[object Object]")。
4. 遍历过程中能否删除或新增条目
在 for...of 或 forEach 遍历 Map 时,规范明确允许调用 map.delete(key) 删除当前键或尚未访问的键——尚未访问的键被删掉后不会再被遍历到;如果在遍历途中调用 map.set() 新增了一个之前不存在的键,这个新键会在后续迭代中被访问到(若修改已有键的值,则会按新值读取,但不会改变原有插入位置)。
四、常见问题排查与方法速查总结
除了前面提到的 map['key'] 和对象引用不匹配,排查 Map 取值异常时还有两个容易忽视的细节:
JSON.stringify(map)结果是"{}":JSON.stringify只会序列化对象自身的可枚举字符串属性,不会读取Map的内部条目表。如果必须转成 JSON 传输,应改为JSON.stringify([...map])(保留非字符串键结构),或在键全为字符串时使用JSON.stringify(Object.fromEntries(map))。- 统计条数用
map.size,不要用Object.keys(map).length:map.size直接返回内部条目数;Object.keys(map)只能拿到误挂在实例上的普通属性,对正常存入的Map数据永远返回0。
JavaScript实现汉诺塔算法:递归逻辑详解与代码示例
2026-11-17 22:35:22
JS回调函数中为何常使用函数表达式而非声明
2026-11-17 19:13:24
JS数组怎么在末尾添加元素?push用法与返回值说明
2026-11-17 19:11:17
JS表格排序怎么处理中文拼音及日期格式
2026-11-17 16:31:58
JS怎么从数组中随机选取一个或多个不重复元素
2026-11-17 15:48:43








