JavaScript Set和Map集合怎么遍历?keys、values与entries用法详解
深入详解JavaScript中Set与Map集合的遍历机制,全面对比keys()、values()、entries()方法及for...of、forEach的实战用法与核心区别。
遍历 JavaScript 中的 Set 与 Map 集合,最标准的做法是利用它们内置的三个迭代器方法:keys()、values() 与 entries(),并配合 for...of 循环或扩展运算符消费数据。Set 与 Map 均严格遵循元素的“插入顺序”进行迭代,但由于 Set 仅保存独立值、Map 保存键值对,两者在这三个方法的返回值结构和默认迭代器绑定上存在着关键差异。
一、Set 与 Map 的迭代模型与底层协议
在 ECMAScript 6(ES2015)规范中,Set 和 Map 原生实现了“可迭代协议(Iterable Protocol)”。这意味着它们的实例都拥有一个名为 Symbol.iterator 的内置属性,该属性是一个工厂函数,每次调用都会生成一个符合规范的迭代器(Iterator)对象。
理解集合遍历的核心,在于弄清楚集合的三个核心方法如何产出迭代器:
keys():返回一个包含集合中所有“键”的迭代器。values():返回一个包含集合中所有“值”的迭代器。entries():返回一个包含集合中所有[键, 值]二元数组的迭代器。
由于两个数据结构的存储模型不同,底层对默认迭代器(即直接在循环中使用集合对象时触发的迭代器)的设定也不同:Set 的默认迭代器是 values(),而 Map 的默认迭代器是 entries()。了解这一机制,在编写 for...of 循环时就能省去不必要的方法调用。
二、Set 集合的遍历方式与方法详解
Set 是一组不重复值的集合。在设计上,Set 只有“值”(Value),并没有像对象或 Map 那样的独立“键”(Key)。但为了与 Map 和其他类集合对象保持统一的 API 契约,ECMAScript 依然为 Set 提供了完整的 keys()、values() 和 entries() 三个方法。
1. set.keys() 与 set.values() 的等价性
在 Set 集合中,set.keys() 与 set.values() 完全等价。规范为了兼容性,让 set.keys() 直接作为 set.values() 的别名存在。调用两者都会返回一个逐项输出集合元素的 SetIterator。
// 初始化包含技术标签的 Set 集合
const frameworkSet = new Set(['React', 'Vue', 'Angular']);
// 1. 使用 values() 遍历
for (const val of frameworkSet.values()) {
console.log(val); // 依次输出: 'React', 'Vue', 'Angular'
}
// 2. keys() 产生完全相同的结果
for (const key of frameworkSet.keys()) {
console.log(key); // 依次输出: 'React', 'Vue', 'Angular'
}
// 验证两者的迭代器行为一致性
console.log(frameworkSet.keys === frameworkSet.values); // true (在许多现代引擎中指向同一底层方法)
2. set.entries():为什么返回 [value, value]?
调用 set.entries() 时,迭代器产出的每一项都是形如 [value, value] 的二元数组,其中键和值完全一致。这种设计的初衷是便于与 Map 编写通用的集合转换函数。例如在处理通用的键值对迭代器管道时,无论传入 Map 还是 Set,都可以通过解构 [k, v] 顺利解开数据而不会崩溃。
for (const [key, value] of frameworkSet.entries()) {
console.log(key, value);
// 输出:
// 'React' 'React'
// 'Vue' 'Vue'
// 'Angular' 'Angular'
}
3. Set 的直接遍历与 forEach
在实际开发中,如果只是想按顺序读取 Set 中的每个元素,最简洁的做法是直接在 for...of 循环中使用 Set 实例本身。也可以使用 forEach 方法,但要注意回调函数的参数约定:
// 推荐实践:直接利用默认迭代器(等同于 .values())
for (const item of frameworkSet) {
console.log('当前框架:', item);
}
// 使用 forEach 方法:为了与 Map.prototype.forEach 保持参数列表签名一致,
// 其回调参数为 (value, key, ownerSet),这里的 value 与 key 严格相等
frameworkSet.forEach((value, key) => {
console.log(`value: ${value}, key: ${key}`); // 两者输出相同字符串
});
三、Map 集合的遍历方式与方法详解
Map 是严格的键值对集合,它的键不仅限于字符串或 Symbol,函数、对象或任意基本类型都能作为键。因此,在遍历 Map 时,keys()、values() 与 entries() 承担着各自分工清晰的数据抽取任务。
1. map.keys() 与 map.values() 的分离提取
当只需要处理所有键或者只需要汇总所有数据值时,调用对应的迭代器能最大化提高代码意图的清晰度:
const userRoles = new Map([
['alice', 'SuperAdmin'],
['bob', 'Editor'],
['charlie', 'Viewer']
]);
// 场景 A:仅提取并遍历所有用户名 (Keys)
for (const username of userRoles.keys()) {
console.log('用户名:', username);
}
// 示例输出: 'alice', 'bob', 'charlie'
// 场景 B:仅提取并检查所有角色权限 (Values)
for (const role of userRoles.values()) {
console.log('已分配角色:', role);
}
// 示例输出: 'SuperAdmin', 'Editor', 'Viewer'
2. map.entries() 与默认迭代解构
map.entries() 返回的是包含 [key, value] 二元数组的迭代器。由于 Map 的 Symbol.iterator 默认指向 entries,因此遍历整个键值映射时,推荐直接在 for...of 中利用数组解构语法:
// 经典写法:利用默认 entries 迭代器结合数组解构
for (const [user, role] of userRoles) {
console.log(`用户 ${user} 的当前系统权限是: ${role}`);
}
// 显式调用 entries() 与上述写法等价
for (const [user, role] of userRoles.entries()) {
// 同样解构获取 user 与 role
}
3. map.forEach 的参数陷阱
使用 map.forEach() 时,初学者极易因为习惯而弄错回调参数的顺序。与常见数组 forEach((item, index) => ...) 类似,Map 的设计者将“核心数据”排在第一位,因此其参数顺序是 (value, key, map),值在前,键在后:
// 注意:第一个参数是 value,第二个参数才是 key
userRoles.forEach((role, user) => {
console.log(`${user} -> ${role}`);
});
四、关键规则、避坑指南与高频实战技巧
1. 集合的遍历顺序:绝对保序
与传统的 JavaScript 普通对象(Object 的数字属性会被自动升序排序、非数字属性按添加顺序)不同,Set 和 Map 的遍历顺序百分之百严格与插入顺序(Insertion Order)一致。如果需要维护有序队列或 LRU 缓存,依赖 Map 的这个特性是非常可靠的。
set(key, newValue),这只是一次值的更新,不会改变该键在 Map 中的原始插入位置。只有先 delete(key) 再 set(key, newValue),该键才会移动到集合的尾部。
2. 遍历时动态增删元素会怎样?
在 for...of 遍历 Set 或 Map 的过程中,如果动态调用 add() 或 set() 插入了新项,由于迭代器是实时游标机制,新添加的元素会被后续循环正常访问到;如果在遍历尚未到达某个元素之前删除了它,该元素将不会被访问到。不过为了代码可维护性,通常不建议在循环体内修改正在遍历的集合尺寸。
3. 转换为数组与函数式操作
由于 keys()、values()、entries() 返回的都是迭代器而非数组,它们本身没有 map()、filter() 或 reduce() 等数组方法。如果需要使用函数式链式调用,可以使用扩展运算符 ... 或 Array.from() 将其转换为普通数组:
// 技巧 1:从 Map 中筛选出特定条件的项构建新 Map
const scores = new Map([
['语文', 85],
['数学', 96],
['英语', 58]
]);
// 过滤出及格科目:先转为 entries 数组,过滤后再传给 new Map
const passedScores = new Map(
[...scores.entries()].filter(([subject, score]) => score >= 60)
);
console.log([...passedScores.keys()]); // ['语文', '数学']
// 技巧 2:Set 去重后做映射计算
const rawIds = [10, 20, 10, 30, 20];
const uniqueSquared = [...new Set(rawIds)].map(n => n * n);
console.log(uniqueSquared); // [100, 400, 900]
五、总结:如何选择最合适的遍历手段?
掌握 Set 和 Map 的遍历,只需要记住以下简短规律:
- 对于 Set:直接使用
for (const item of set)遍历是最佳实践;keys()与values()作用完全相同;entries()仅在泛型算法对齐时使用。 - 对于 Map:需要键值全量数据时,首选
for (const [key, value] of map)(利用默认entries解构);只关心键名用map.keys();只关心数值用map.values()。 - 需要使用数组的高阶方法时,用
[...set]或[...map.values()]快速展开成数组。
JS默认参数中undefined与null的区别是什么
2026-11-21 08:49:05
利用JavaScript延时函数实现防抖和节流操作
2026-11-20 21:48:02
JS数组pop和shift方法:快速移除首尾元素
2026-11-20 20:50:55
JS正则表达式批量替换或去除字符串中的换行符
2026-11-20 20:41:56
JS遍历对象数组时怎么正确处理async/await异步操作
2026-11-20 19:54:12








