Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Map.prototype.delete: odstranitev vnosa po ključu

Metoda delete odstrani vnos Map, ki ustreza podanemu ključu, in vrne true samo, če je tak vnos obstajal.

Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaksa

map.delete(key)

map.delete(key) poišče ključ brez pretvorbe tipa. Če vnos obstaja, označi zapis kot prazen in vrne true; sicer pusti Map nespremenjen ter vrne false. Odstranjen je celoten par ključ–vrednost, size pa se zmanjša za ena le po uspešni odstranitvi.

Ključi uporabljajo SameValueZero: NaN se ujema z NaN, -0 pa z +0; objekti se ujemajo le po identiteti sklica. Vrstni red preostalih vnosov se ne spremeni. Kasnejši set istega ključa ustvari nov zapis na koncu vrstnega reda iteracije, aktivni iteratorji pa odstranjeni zapis preskočijo.

Prejemnik mora biti pravi Map z notranjimi podatki Map; objekt, Set ali neobravnavan Proxy kot this sproži TypeError. Metoda je standardna od ECMAScript 2015. Logični rezultat razlikuje manjkajoči ključ od obstoječega vnosa, katerega vrednost je bila undefined.

Primeri

const token = {};
const map = new Map([[token, "active"], [NaN, "unknown"], ["tail", 3]]);
console.log(map.delete({}), map.size);
console.log(map.delete(token), map.has(token), map.size);
console.log(map.delete(NaN), map.delete(NaN));

const ordered = new Map([["a", 1], ["b", 2]]);
ordered.delete("a");
ordered.set("a", 3);
console.log([...ordered.keys()].join(","));

try {
  Map.prototype.delete.call({}, "a");
} catch (error) {
  console.log(error instanceof TypeError);
}

Rezultat

false 3
true false 2
true false
b,a
true

Viri