База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Map.prototype.set: записване на запис

Методът set добавя или обновява двойка ключ–стойност в Map и връща същия Map за верижно извикване.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

map.set(key, value)

map.set(key, value) записва без преобразуване и връща приемащия Map. Нов ключ се добавя в края на реда на вмъкване. Обновяване заменя стойността без промяна на size или позицията; едва delete и после set създават нова позиция в края.

Ключовете използват SameValueZero: NaN съвпада с NaN, а -0 се нормализира до +0. Обектните ключове и стойности остават същите препратки без клониране. Резултатът позволява map.set(a, 1).set(b, 2).

Получателят трябва да има вътрешни данни на Map; обект, Set или необработен Proxy хвърля TypeError. Стандартен от ECMAScript 2015. При get-or-create съществуваща стойност може да е undefined, затова само get не винаги проверява наличие.

Примери

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); }

Резултат

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

Източници