JS Map怎么遍历:forEach与for...of用法示例

作者:代码拾荒

时间:2026-11-19

浏览:642

全面讲解JavaScript中Map集合的遍历方案,深度剖析forEach与for...of的语法规则、回调参数顺序细节、数组解构技巧、中断控制流及异步await支持,附带完整工程图解与避坑指南。

文章目录
JavaScript 核心特性 ES6 Collection API 阅读时长:约 8 分钟 适用规范:ECMAScript 2015 (ES6) 及更高标准
JS Map怎么遍历:forEach与for...of用法示例
在 JavaScript 中,Map 是一种保存键值对且严格保持插入顺序的高级集合。遍历 Map 的核心方案有两个:通过实例方法 Map.prototype.forEach() 执行回调,或者使用符合 ES6 迭代协议的 for...of 循环配合 map.entries()、map.keys() 与 map.values()。理解两者的区别在于掌握回调函数的参数顺序设计、循环中断控制以及异步等待机制。

一、JS Map 的底层迭代机制与数据结构特点

在深入具体语法前,首先需要理解 Map 与普通对象(Object)在底层结构上的本质差异。普通对象的属性键在遍历时会经过字符串转换且顺序规则复杂(整数键优先升序、其余按创建顺序),且普通对象没有实现默认的迭代器。

Map 规范在底层通过双向链表与哈希槽维护所有条目。无论键是字符串、数字、对象引用还是 Symbol,每个键值对都严格按照 map.set(key, value) 的调用先后顺序排列。更关键的是,Map 实现了 ES6 的 可迭代协议(Iterable Protocol),其原型上默认部署了 [Symbol.iterator]() 方法。

JS Map怎么遍历:forEach与for...of用法示例
图 1:Map 内部数据组织与三种迭代器派生结构(展示原型迭代接口与回调通道关系)

如上图所示,一个 Map 实例对外暴露了四条清晰的遍历数据流通道:

  • 默认迭代器 [Symbol.iterator]():等价于调用 map.entries(),按序产出 [key, value] 构成的二元数组。
  • map.keys() 迭代器:仅抽取键名序列,产出 MapIterator<Key>。
  • map.values() 迭代器:仅抽取数值序列,产出 MapIterator<Value>。
  • map.forEach(callback) 遍历通道:引擎内部主动驱动游标,逐项调用开发者传入的回调函数。

二、使用 forEach 遍历 Map:回调参数与用法细节

Map.prototype.forEach() 是借鉴自数组的函数式遍历方法。其基础调用签名如下:

map.forEach(callback(value, key, map)[, thisArg]);

1. 核心示例:基础键值访问

我们准备一份包含用户信息与权限的 Map 实例,并使用 forEach 进行打印处理:

// 1. 初始化包含不同类型键的 Map 实例
const userRoleMap = new Map();
userRoleMap.set('user_101', { name: '张伟', role: 'admin' });
userRoleMap.set('user_102', { name: '李娜', role: 'editor' });
userRoleMap.set('user_103', { name: '王强', role: 'viewer' });

// 2. 使用 forEach 执行回调遍历
userRoleMap.forEach((val, k) => {
  console.log(`[用户键] ${k} => 姓名: ${val.name}, 角色: ${val.role}`);
});
示例输出 (Console Output) [用户键] user_101 => 姓名: 张伟, 角色: admin [用户键] user_102 => 姓名: 李娜, 角色: editor [用户键] user_103 => 姓名: 王强, 角色: viewer
JS Map怎么遍历:forEach与for...of用法示例
图 2:Map.prototype.forEach 执行管道与参数分发时序图
⚠️ 极高频陷阱提醒:回调参数顺序为 (value, key),并非 (key, value)!
许多开发者初次使用 map.forEach((key, value) => ...) 时,直觉认为键应该排在第一位。然而,ECMA 规范为了与 Array.prototype.forEach(item, index, array) 保持设计签名的一致性,将“被遍历的元素主体”(即 value)放在第一个实参,将“键/索引”(即 key)放在第二个实参。
若写反变量名,key 将接收到对象值,而 value 将接收到键名字符串!

2. 使用 thisArg 传递上下文

forEach 支持传入第二个可选参数 thisArg。当回调使用常规 function 声明时,函数内部的 this 将指向该对象:

const roleFormatter = {
  prefix: '【系统授权记录】',
  format(key, role) {
    return `${this.prefix} ID: ${key} 权限级: ${role.toUpperCase()}`;
  }
};

const authMap = new Map([
  ['sys_admin', 'super'],
  ['guest_user', 'read_only']
]);

// 传入 roleFormatter 作为 thisArg(注意不能使用箭头函数)
authMap.forEach(function(val, key) {
  console.log(this.format(key, val));
}, roleFormatter);
示例输出 (Console Output) 【系统授权记录】 ID: sys_admin 权限级: SUPER 【系统授权记录】 ID: guest_user 权限级: READ_ONLY

3. forEach 的控制流限制

forEach 的本质是高阶函数执行,其在控制流方面具有硬性限制:

  • 无法使用 break 或 continue:在回调函数内部写 break 或 continue 会直接抛出语法错误 SyntaxError: Illegal break statement。
  • return 无法终止遍历:回调函数内部的 return 仅仅相当于普通循环中的 continue,只会退出当前这一项的回调执行,Map 会继续调用下一项。

三、使用 for...of 遍历 Map:解构赋值与三种遍历形态

由于 Map 实现了标准迭代器协议,for...of 是现代 JavaScript 中最推荐、表达力最强的遍历手段。配合 ES6 数组解构语法,不仅语义清晰,而且完全支持所有常规流程控制。

JS Map怎么遍历:forEach与for...of用法示例
图 3:for...of 迭代协议执行流程与控制流网关图

1. 形态一:默认直接遍历(键值对数组解构)

直接在 map 上运行 for...of,每次迭代器会产出一个长度为 2 的数组 [key, value]。利用解构赋值可以直接提取:

const productStock = new Map([
  ['SKU_APPLE', 45],
  ['SKU_BANANA', 0],
  ['SKU_ORANGE', 82],
  ['SKU_PEACH', 19]
]);

// 结合解构语法直接提取 key 与 value
for (const [sku, stock] of productStock) {
  if (stock === 0) {
    console.log(`[告警] ${sku} 当前缺货,跳过处理`);
    continue; // 完美支持 continue 跳过当前项
  }
  
  if (stock > 80) {
    console.log(`[达标] 发现高库存商品 ${sku} (${stock}件),停止后续扫描`);
    break; // 完美支持 break 立即跳出整轮循环
  }
  
  console.log(`[正常] ${sku} 正常在售,剩余 ${stock} 件`);
}
示例输出 (Console Output) [正常] SKU_APPLE 正常在售,剩余 45 件 [告警] SKU_BANANA 当前缺货,跳过处理 [达标] 发现高库存商品 SKU_ORANGE (82件),停止后续扫描

2. 形态二:使用 map.keys() 仅遍历键名

当业务只需要核验配置键名或做存在性匹配时,通过 map.keys() 避免解构开销:

const featureFlags = new Map([
  ['beta_chat', true],
  ['dark_mode', false],
  ['export_pdf', true]
]);

console.log('当前系统注册的功能开关键名:');
for (const featureName of featureFlags.keys()) {
  console.log(`- 模块节点: ${featureName}`);
}
示例输出 (Console Output) 当前系统注册的功能开关键名: - 模块节点: beta_chat - 模块节点: dark_mode - 模块节点: export_pdf

3. 形态三:使用 map.values() 仅遍历值

当执行纯数据聚合(如求和、平均值统计)且无需关注关联键时,直接使用 map.values():

const expenseMap = new Map([
  ['server_fee', 1200],
  ['domain_dns', 85],
  ['cdn_traffic', 430]
]);

let totalCost = 0;
for (const amount of expenseMap.values()) {
  totalCost += amount;
}
console.log(`月度服务基础开销总计: ¥${totalCost}`);
示例输出 (Console Output) 月度服务基础开销总计: ¥1715

4. 关键优势:与 async / await 协同的串行执行

在需要依次向远端 API 请求数据或写入数据库的场景下,for...of 是唯一能够严格实现“逐项等待”的遍历方式:

// 模拟异步任务执行函数
function simulateRemoteSync(taskKey, payload) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve(`任务 [${taskKey}] 同步成功,状态: ${payload.status}`);
    }, 200);
  });
}

async function processQueue() {
  const queue = new Map([
    ['SYNC_TASK_A', { status: 'PENDING' }],
    ['SYNC_TASK_B', { status: 'READY' }]
  ]);

  for (const [taskKey, payload] of queue) {
    // 能够在此真正阻断并等待异步兑现
    const result = await simulateRemoteSync(taskKey, payload);
    console.log(result);
  }
  console.log('全部任务按序同步完毕。');
}

processQueue();
示例输出 (Console Output) 任务 [SYNC_TASK_A] 同步成功,状态: PENDING 任务 [SYNC_TASK_B] 同步成功,状态: READY 全部任务按序同步完毕。

四、forEach 与 for...of 的深度对比与选型指南

虽然两者都能完成对 Map 元素的遍历,但在技术特征、控制能力与团队工程规范上存在明显分野。

JS Map怎么遍历:forEach与for...of用法示例
图 4:Map 遍历方式决策树与全维度技术指标对比矩阵

以下是两者在核心维度上的具体对比表:

评估维度 map.forEach(callback) for (const [k, v] of map)
控制流中断 (break) 不支持(语法报错) 原生支持,立即跳出循环
单项跳过 (continue) 使用 return 模拟 原生支持 continue 关键字
异步串行 (async/await) 不支持串行等待(产生并发游离 Promise) 原生支持严格按序 await 等待
参数可读性 (value, key) 顺序反直觉,易颠倒 [key, value] 显式模式匹配,清晰直观
this 上下文绑定 支持第二个参数 thisArg 显式指定 直接继承外层 Lexical 词法作用域
仅遍历键或值 需忽略不需要的形参(如 (_, key)) 支持 .keys() / .values() 专属流
💡 选型建议速查:
  • 首选 for...of:任何涉及条件搜索、需要中途退出、包含异步请求,或者希望团队代码语义清晰度最大化的生产环境代码,都应当默认选择 for...of。
  • 选择 forEach:当逻辑属于纯函数式、不需要提前退出、代码极短且希望链式风格时,可使用 forEach。

五、常见避坑指南与遍历最佳实践

1. 避坑一:在 forEach 中滥用 async 回调

在 forEach 的回调函数前加上 async,代码虽然不会报错,但它完全无法按预期串行阻塞:

// 错误示例:forEach 无法等待内部 Promise
async function wrongPattern(map) {
  console.log('开始执行...');
  map.forEach(async (val, key) => {
    await someAsyncTask(val);
    console.log(`完成: ${key}`);
  });
  console.log('所有操作已结束?'); // 此行会立即输出,并不会等待上面的 await!
}

原因:Map.prototype.forEach 内部是一个同步循环,它调用回调后不会检查或等待回调返回的 Promise。若要实现真正的顺序执行,必须改写为 for (const [k, v] of map)。

2. 避坑二:遍历中修改 Map 的边界行为

ECMAScript 规范明确定义了在遍历活跃状态下修改集合的行为:

  • 动态新增键:如果在遍历过程中调用 map.set(newKey, val) 添加了一个此前不存在的新键,该新键会被后续遍历访问到。如果无限制在循环内新增键,将造成死循环。
  • 动态删除键:如果在尚未遍历到某键之前调用 map.delete(targetKey),该键将不会被遍历;如果删除的是已经遍历过的键,不影响后续遍历。
const activeMap = new Map([['A', 1], ['B', 2]]);

for (const [k, v] of activeMap) {
  console.log(`访问键: ${k}`);
  if (k === 'A') {
    activeMap.set('C', 3); // 动态追加新键
  }
}
示例输出 (Console Output) 访问键: A 访问键: B 访问键: C <-- 新增的键如约被访问到

3. 避坑三:切勿将 for...in 误用于 Map

很多习惯了遍历普通对象或数组属性的开发者会写出 for (const k in map)。在 Map 实例上使用 for...in:

  • for...in 遍历的是对象及其原型链上的可枚举属性名(Enumerable Properties)。
  • Map 中通过 set() 存入的键值对保存在内部数据槽中,并非对象的自身属性。因此 for...in 根本不会遍历出任何 Map 内部的键值对!

六、工程实践总结清单

为确保生产环境代码的健壮性与可维护性,建议团队在开发中遵循以下检查清单:

  1. 默认推荐结构:以 for (const [key, value] of map) 作为团队标准遍历形态,键在前、值在后,直观明确。
  2. 按需选用特定迭代器:只要键名时使用 map.keys(),只要数值时使用 map.values(),避免无意义的完整解构与垃圾分配。
  3. 严查 forEach 形参顺序:若选用 forEach,始终牢记第一个参数是 value,第二个参数才是 key。
  4. 拒绝在 forEach 中写 await:需要异步等待时,坚决使用 for...of 循环体。

实用工具推荐

电子包浆

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

使用 ›
图片压缩

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

使用 ›
相关文章