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

View in English Always switch to English

Map.prototype.set()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。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");

仕様書

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

ブラウザーの互換性

関連情報