JavaScript Map集合怎么取值?get方法与遍历技巧

作者:纸飞机

时间:2026-11-17

浏览:198

详细讲解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() 等迭代器方法。

JavaScript Map集合怎么取值?get方法与遍历技巧
图 0:Map 集合通过内部条目表存储任意类型键,分别支持 get() 单点读取与多种有序遍历方式

一、用 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'));
示例输出林远 普通会员 undefined undefined

注意上面第三行输出:数字 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'));
示例输出undefined true false

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));
示例输出用户详情 undefined 非数字标记
常见误区提醒:不要用中括号或点语法读写 Map
Map 本质上也是一个 JavaScript 对象,因此语法上允许你写 cache['role'] = 'admin',但这种写法只是在 cache 实例上挂了一个普通对象属性,并没有放进 Map 的内部集合里。结果就是 cache.size 不会增加,cache.get('role') 依然返回 undefined,所有遍历方法也看不到它。
JavaScript Map集合怎么取值?get方法与遍历技巧
图 1:map.get() 查询内部条目表,而中括号语法读写的是对象自身属性,两者互不相通

二、批量取值:四种遍历技巧与适用区别

当需要把整个 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;
  }
}
示例输出找到高分科目:数学 (95)

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} 元`);
});
示例输出苹果 单价:6.5 元 香蕉 单价:4 元

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);
示例输出库存总件数: 55

4. 显式获取键值对迭代器:entries()

map.entries() 返回包含所有 [key, value] 对的迭代器,行为与直接遍历 map 本身一致。当代码需要清晰表达“这里正在取键值对”,或者要把迭代器传给接收可迭代对象的工具函数时,显式写出 .entries() 可读性更好。

JavaScript Map集合怎么取值?get方法与遍历技巧
图 2:Map 四种遍历方式的数据产出格式、参数顺序与循环控制能力对比

三、实用取值与转换技巧

了解基本语法之后,实际写业务代码时还会遇到“键不存在给默认值”、“按条件过滤 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);
示例输出3 0 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() 新增了一个之前不存在的键,这个新键会在后续迭代中被访问到(若修改已有键的值,则会按新值读取,但不会改变原有插入位置)。

JavaScript Map集合怎么取值?get方法与遍历技巧
图 3:根据单键查找、流式遍历或集合转换三类需求选择对应的 Map 操作路径

四、常见问题排查与方法速查总结

除了前面提到的 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 Map集合怎么取值?get方法与遍历技巧
图 4:JavaScript Map 集合常用取值与遍历方案速查对比

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章