このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Map.prototype.set()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

set()Map インスタンスのメソッドで、指定されたキーと値を持つ新しい項目をこの対応表 (Map) に追加し、キーがすでに存在する場合は既存の項目を更新します。

試してみましょう

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

console.log(map.get("bar"));
// 予想される結果: "foo"

console.log(map.get("baz"));
// 予想される結果: undefined

構文

js
set(key, value)

引数

key

この Map オブジェクト内で追加または変更する項目のキーです。どのような値でも指定できます。オブジェクトのキーは、値ではなく 参照 によって比較されます。

value

この Map オブジェクト内で追加または変更する項目の値です。どのような値でも指定できます。

返値

Map オブジェクトです。

set() の使用

js
const myMap = new Map();

// 対応表に新しい要素を追加する
myMap.set("bar", "foo");
myMap.set(1, "foobar");

// 対応表にある要素を更新する
myMap.set("bar", "baz");

set() のメソッドチェーンの使用

set() メソッドは Map オブジェクトを返すため、以下のようにメソッドチェーンを作ることができます。

js
// チェーンを使用して対応表に新しい要素を追加する
myMap.set("bar", "foo").set(1, "foobar").set(2, "baz");

仕様書

Specification
ECMAScript® 2027 Language Specification
# sec-map.prototype.set

ブラウザーの互換性

関連情報