Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Map.prototype.delete: odstranění položky podle klíče

Metoda delete odstraní položku Map odpovídající zadanému klíči a vrátí true pouze tehdy, když taková položka existovala.

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

Syntaxe

map.delete(key)

map.delete(key) vyhledá klíč bez převodu typu. Pokud položka existuje, označí její záznam jako prázdný a vrátí true; jinak ponechá Map beze změny a vrátí false. Odstraní se celá dvojice klíč–hodnota a size se sníží o jednu pouze po úspěšném odstranění.

Klíče používají SameValueZero: NaN odpovídá NaN a -0 odpovídá +0; objekty odpovídají jen podle identity odkazu. Pořadí ostatních položek se nemění. Pozdější set stejného klíče vytvoří nový záznam na konci pořadí iterace a aktivní iterátory odstraněný záznam přeskočí.

Příjemce musí být skutečná Map s interními daty Map; objekt, Set nebo neošetřený Proxy jako this vyvolá TypeError. Metoda je standardní od ECMAScript 2015. Booleovský výsledek odliší chybějící klíč od existující položky, jejíž hodnotou bylo undefined.

Příklady

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

Výsledek

false 3
true false 2
true false
b,a
true

Zdroje