简介 使用 输出 语句 语法 注释 变量 Let Const 运算符 算数 赋值 数据类型 函数 对象 事件 字符串 字符串方法 字符串搜索 字符串模板 数字 BigInt 数字方法 数字属性 数组 数组方法 数组搜索 数组排序 数组迭代 数组 Const 日期 日期格式 日期获取方法 日期设置方法 数学 随机 逻辑 比较 条件 Switch Loop For Loop For In Loop For Of Loop While Break 可迭代对象 Set Set 方法 Map Map 方法 typeof 类型转换 解构 位运算 正则表达式 运算符优先级 异常 作用域 Hoisting 严格模式 this 关键词 箭头函数 类 模块 JSON 调试 样式指南 最佳实践 错误 性能 保留词 JS 版本 JS 2009 (ES5) JS 2015 (ES6) JS 2016 JS 2017 JS 2018 JS 2019 JS 2020 JS 2021 JS 2022 JS 2023 JS 2024 JS IE / Edge JS 历史 对象定义 对象属性 对象方法 对象显示 对象访问器 对象构造器 对象原型 对象引用 函数定义 函数参数 函数调用 函数 Call 函数 Apply 函数绑定 闭包 类简介 类继承 Static 回调 异步 Promise Async DOM 简介 DOM 方法 DOM 文档 DOM 元素 DOM HTML DOM 表单 DOM CSS DOM 动画 DOM 事件 DOM 事件监听程序 DOM 导航 DOM 节点 DOM 集合 DOM 节点列表 Window Screen Location History Navigator 弹出框 Timing Cookies Web API 简介 Web Form API Web History API Web Storage API Web Worker API Web Fetch API Web Geolocation API AJAX 简介 AJAX XMLHttp AJAX 请求 AJAX 响应 AJAX XML 文件 AJAX PHP AJAX ASP AJAX 数据库 AJAX 应用程序 AJAX 实例 JSON 简介 JSON 语法 JSON vs XML JSON 数据类型 JSON 解析 JSON 字符串化 JSON 对象 JSON 数组 JSON 服务器 JSON PHP JSON HTML JSON JSONP jQuery 选择器 jQuery HTML jQuery CSS jQuery DOM 图形 Canvas Plotly.js Chart 谷歌图表 D3.js 参考手册(类别排序) 参考手册(字母排序)

JavaScript

浏览4271
更新时间2025-08-07

new Map() 方法

可以通过将数组传递给 new Map() 构造函数来创建 Map:

实例

// 创建一个 Map
const fruits = new Map([
  ["apples", 500],
  ["bananas", 300],
  ["oranges", 200]
]);
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.get()

可以使用 get() 方法获取 Map 中键的值:

实例

fruits.get("apples");
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.set()

可以使用 set() 方法向 Map 添加元素:

实例

// 创建一个 Map
const fruits = new Map();

// 设置 Map 值
fruits.set("apples", 500);
fruits.set("bananas", 300);
fruits.set("oranges", 200);
运行实例 »

点击 "运行实例" 按钮查看在线实例

set() 方法也可以用于更改现有的 Map 值:

实例

fruits.set("apples", 500);
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.size

size 属性返回 Map 中元素的数量:

实例

fruits.size;
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.delete()

delete() 方法移除 Map 中的一个元素:

实例

fruits.delete("apples");
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.clear()

clear() 方法移除 Map 中的所有元素:

实例

fruits.clear();
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.has()

如果 Map 中存在某个键,has() 方法返回 true:

实例

fruits.has("apples");
运行实例 »

点击 "运行实例" 按钮查看在线实例

尝试以下代码:

fruits.delete("apples");
fruits.has("apples");
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.forEach()

forEach() 方法为 Map 中的每个键值对调用回调函数:

实例

// 列出所有条目
let text = "";
fruits.forEach(function(value, key) {
  text += key + ' = ' + value;
});
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.entries()

entries() 方法返回一个包含 Map 中 [key, value] 对的迭代器对象:

实例

// 列出所有条目
let text = "";
for (const x of fruits.entries()) {
  text += x;
}
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.keys()

keys() 方法返回一个包含 Map 中键的迭代器对象:

实例

// 列出所有键
let text = "";
for (const x of fruits.keys()) {
  text += x;
}
运行实例 »

点击 "运行实例" 按钮查看在线实例

Map.values()

values() 方法返回一个包含 Map 中值的迭代器对象:

实例

// 列出所有值
let text = "";
for (const x of fruits.values()) {
  text += x;
}
运行实例 »

点击 "运行实例" 按钮查看在线实例

可以使用 values() 方法对 Map 中的值求和:

实例

// 对所有值求和
let total = 0;
for (const x of fruits.values()) {
  total += x;
}
运行实例 »

点击 "运行实例" 按钮查看在线实例

对象作为键

提示:能够使用对象作为键是 Map 的一个重要特性。

实例

// 创建对象
const apples = {name: 'Apples'};
const bananas = {name: 'Bananas'};
const oranges = {name: 'Oranges'};

// 创建一个 Map
const fruits = new Map();

// 向 Map 添加新元素
fruits.set(apples, 500);
fruits.set(bananas, 300);
fruits.set(oranges, 200);
运行实例 »

点击 "运行实例" 按钮查看在线实例

注意:键是对象(apples),而不是字符串("apples"):

实例

fruits.get("apples"); // 返回 undefined
运行实例 »

点击 "运行实例" 按钮查看在线实例

JavaScript Map.groupBy()

ES2024 向 JavaScript 添加了 Map.groupBy() 方法。

Map.groupBy() 方法根据回调函数返回的字符串值对对象的元素进行分组。

Map.groupBy() 方法不会更改原始对象。

实例

// 创建一个数组
const fruits = [
  {name: "apples", quantity: 300},
  {name: "bananas", quantity: 500},
  {name: "oranges", quantity: 200},
  {name: "kiwi", quantity: 150}
];

// 用于分组的回调函数
function myCallback({ quantity }) {
  return quantity > 200 ? "ok" : "low";
}

// 按数量分组
const result = Map.groupBy(fruits, myCallback);
运行实例 »

点击 "运行实例" 按钮查看在线实例

浏览器支持

Map.groupBy() 是 ES2024 的特性。

自 2024 年 3 月起,新浏览器均支持该特性:

Chrome Edge Firefox Safari Opera
Chrome 117 Edge 117 Firefox 119 Safari 17.4 Opera 103
2023 年 9 月 2023 年 9 月 2023 年 10 月 2024 年 10 月 2023 年 5 月

警告:

ES2024 特性相对较新。

旧版浏览器可能需要替代代码(Polyfill)。

Object.groupBy() 与 Map.groupBy() 的区别

Object.groupBy() 和 Map.groupBy() 的区别在于:

Object.groupBy() 将元素分组到 JavaScript 对象中。

Map.groupBy() 将元素分组到 Map 对象中。

完整的 Map 参考手册

如需完整参考,请访问我们的:JavaScript Map 参考手册。

该手册包含所有 Map 属性和方法的描述和实例。

相关视频

更多

免费

前端入门_HTML5
初级前端入门_HTML5

64.8万次学习

收藏

免费

30分钟学会网站布局
初级30分钟学会网站布局

24.6万次学习

收藏

免费

CSS视频教程-玉女心经版
初级CSS视频教程-玉女心经版

41.1万次学习

收藏

免费

JavaScript极速入门_玉女心经系列
初级JavaScript极速入门_玉女心经系列

76.4万次学习

收藏

精品课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

65万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

41.3万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

76.7万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

64.1万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

24.4万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

36.2万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

133.2万人学习

热门下载

更多
phpStudy 2018最新版
phpStudy 2018最新版

集成PHP7,16种组合,超全大合集

下载

VC9 32位
VC9 32位

VC9 32位 phpstudy集成安装环境运行库

下载

VC11 32位
VC11 32位

VC11 32位 phpstudy集成安装环境运行库​

下载

php程序员工具箱完整版
php程序员工具箱完整版

程序员工具箱 v1.0 php集成环境

下载

VC14 32位
VC14 32位

VC14 32位 phpstudy安装环境运行库

下载

SublimeText3汉化版
SublimeText3汉化版

中文版,非常好用

下载

Notepad++ Windows版
Notepad++ Windows版

Notepad++ 8.9.7 Windows版官方安装包,适合 Windows 用户进行代码编辑、文本处理、语法高亮和插件扩展配置。

下载