Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Map.prototype.set: zapis wpisu

Metoda set dodaje lub aktualizuje parę klucz–wartość w Map i zwraca tę samą Map, co umożliwia łańcuchowanie.

Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2

Składnia

map.set(key, value)

map.set(key, value) zapisuje wartość pod kluczem bez konwersji i zwraca odbiorcę Map. Nowy klucz jest dopisywany na końcu kolejności wstawiania. Aktualizacja istniejącego klucza zastępuje wartość, nie zmienia size i nie przesuwa wpisu; dopiero delete, a potem set tworzy nową pozycję na końcu.

Klucze stosują SameValueZero: NaN odpowiada NaN, a -0 jest normalizowane do +0. Obiekty-klucze i obiekty-wartości są przechowywane jako te same referencje, bez klonowania. Zwrócenie tej samej Map pozwala pisać map.set(a, 1).set(b, 2).

Odbiorca musi mieć wewnętrzne dane Map; zwykły obiekt, Set lub nieobsłużony Proxy powoduje TypeError. Metoda jest standardowa od ECMAScript 2015. Przy wzorcu get-or-create pamiętaj, że istniejąca wartość może być undefined, więc samo get nie zawsze wystarcza do sprawdzenia obecności.

Przykłady

const map = new Map();
console.log(map.set("a", 1) === map);
map.set("b", 2).set("a", 3);
console.log(map.size, [...map.keys()].join(","), map.get("a"));
map.delete("a");
map.set("a", 4);
console.log([...map.keys()].join(","));
const key = {};
const value = {};
map.set(key, value);
console.log(map.get(key) === value);
map.set(NaN, 1).set(NaN, 2).set(-0, "zero");
console.log(map.get(NaN), map.get(+0));
try { Map.prototype.set.call({}, "x", 1); } catch (error) { console.log(error instanceof TypeError); }

Wynik

true
2 a,b 3
b,a
true
2 zero
true

Źródła