CKTIS / JavaScript
Map.prototype.set: zápis položky
Metoda set přidá nebo aktualizuje dvojici klíč–hodnota v Map a vrátí stejnou Map pro řetězení.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
map.set(key, value)map.set(key, value) uloží bez převodu a vrátí přijímající Map. Nový klíč se přidá na konec pořadí vložení. Aktualizace nahradí hodnotu bez změny size či pozice; teprve delete následovaný set vytvoří novou pozici na konci.
Klíče používají SameValueZero: NaN odpovídá NaN a -0 se normalizuje na +0. Objektové klíče i hodnoty zůstávají stejnými odkazy bez klonování. Návrat umožňuje map.set(a, 1).set(b, 2).
Příjemce musí mít interní data Map; objekt, Set či neošetřený Proxy vyvolá TypeError. Standardní od ECMAScript 2015. V get-or-create může být existující hodnota undefined, takže samotné get ne vždy ověří přítomnost.
Příklady
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); }Výsledek
true 2 a,b 3 b,a true 2 zero true