CKTIS / JavaScript
WeakMap.prototype.delete() — премахване на запис
Извикай `weakMap.delete(key)`, за да премахнеш записа за даден ключ. Методът връща `true`, ако е премахнал запис, и `false`, ако не е.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
weakMap.delete(key)WeakMap.delete е кратко название на метода на екземпляра WeakMap.prototype.delete. Извиквай го като weakMap.delete(key), а не като статичен метод на конструктора WeakMap. Той премахва връзката между ключа и стойността само от тази колекция. За разлика от оператора delete, методът не премахва свойство на обект.
true означава, че записът е съществувал и е премахнат, дори стойността му да е била undefined. Ако записът липсва, резултатът е false. Ключовете, които са обекти, се сравняват по идентичност: два различни обекта с еднакви свойства не съвпадат. След премахването weakMap.has(key) връща false, освен ако отново не добавиш запис за този ключ.
ECMAScript 2024 допуска като ключове обекти и нерегистрирани символи като Symbol(), но не и символи, получени чрез Symbol.for(). Поддръжката на символи като ключове зависи от средата за изпълнение. При валиден екземпляр delete() връща false за невалиден ключ, например низ, или ако пропуснеш аргумента; set() хвърля TypeError при невалиден ключ. Извикване на delete() без валиден екземпляр като this също хвърля TypeError.
WeakMap не поддържа даден обект жив само защото той служи като ключ. Изричното премахване изтрива записа веднага, дори кодът все още да държи референция към ключа. То не унищожава обекта и не принуждава механизма за автоматично освобождаване на памет да се задейства.
Примери
{
const notes = new WeakMap();
const key = { id: 1 };
notes.set(key, undefined);
console.log(notes.delete({ id: 1 }));
console.log(notes.delete(key));
console.log(notes.has(key));
console.log(notes.delete(key));
console.log(notes.delete("id"));
}Резултат
false true false false false
Отделният обект `{ id: 1 }` не съвпада с `key`. Премахването чрез `key` връща `true`, въпреки че съхранената стойност е `undefined`. След това `has()`, повторното премахване и опитът за премахване с низ като ключ връщат `false`.
Свързани уроци
- JavaScript · Урок 18 · Начално · Версия: 4