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

瀏覽器相容性

另見