Map.prototype.set()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

set() 方法用于向 Map 实例添加一个具有指定键和值的条目,如果键已存在,则更新该条目。

试一试

const map = new Map();
map.set("bar", "foo");

console.log(map.get("bar"));
// Expected output: "foo"

console.log(map.get("baz"));
// Expected output: undefined

语法

js
set(key, value)

参数

key

要添加到 Map 对象或在 Map 对象中修改的条目的键。可以是任何值。对象键按引用比较,而不是按值比较。

value

要添加到 Map 对象或在 Map 对象中修改的条目的值。可以是任何值。

返回值

Map 对象。

示例

使用 set()

js
const myMap = new Map();

// Add new elements to the map
myMap.set("bar", "foo");
myMap.set(1, "foobar");

// Update an element in the map
myMap.set("bar", "baz");

链式使用 set() 方法

由于 set() 方法会返回同一个 Map 对象,因此您可以像下面这样链式调用该方法。

js
// Add new elements to the map with chaining.
myMap.set("bar", "foo").set(1, "foobar").set(2, "baz");

规范

规范
ECMAScript® 2026 语言规范
# sec-map.prototype.set

浏览器兼容性

另见