CKTIS / JavaScript
WeakSet: проверка за принадлежност, добавяне и премахване
Използвай `has()`, за да провериш дали дадена стойност е в множеството, `add()`, за да я добавиш, и `delete()`, за да я премахнеш. Методите връщат различни резултати и реагират различно на недопустими стойности.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete е съкратено означение за три метода на WeakSet.prototype, а не име на един метод. Извиквай ги върху екземпляр, например seen.has(value). Извикване без екземпляр на WeakSet като this хвърля TypeError. Това важи и ако отделиш метода от екземпляра и го извикаш като обикновена функция.
has(value) връща true, ако стойността присъства, и false в противен случай, без да променя множеството. add(value) добавя стойността само ако тя отсъства, и при успех връща същия екземпляр, така че можеш да свързваш извиквания във верига. delete(value) връща true само ако е премахнат елемент; иначе връща false. Принадлежността се определя от идентичността, а не от съдържанието: два отделно създадени обекта { id: 1 } са различни елементи.
ECMAScript 2024 допуска обекти (включително функции) и нерегистрирани символи, например Symbol(). Символите от глобалния регистър, връщани от Symbol.for(), и останалите примитивни стойности, като 1 и null, не са допустими. При недопустима стойност add() хвърля TypeError, докато has() и delete() връщат false. По-старите среди за изпълнение може да приемат само обекти; провери дали целевата среда поддържа символи.
Запис в WeakSet сам по себе си не поддържа стойността жива. Ако стойността вече не е достижима чрез силни референции, паметта ѝ може да бъде освободена автоматично; не разчитай кога ще стане това. Елементите на WeakSet не могат да се обхождат и няма свойство size. Използвай го, за да отбелязваш вече обработени обекти. Ако трябва да обхождаш или преброяваш елементите, използвай Set, който пази силни референции към тях.
Примери
{
const seen = new WeakSet();
const task = { id: 1 };
const lookalike = { id: 1 };
console.log(seen.add(task).add(task) === seen);
console.log(seen.has(task));
console.log(seen.has(lookalike));
console.log(seen.delete(task));
console.log(seen.delete(task));
console.log(seen.has(task));
console.log(seen.has(1));
console.log(seen.delete(1));
try {
seen.add(1);
} catch (error) {
console.log(error instanceof TypeError);
}
}Резултат
true true false true false false false false true
Дори когато добавиш `task` два пъти, резултатът е `seen`. `lookalike` има същото съдържание, но не е елемент на множеството. Само първото премахване на `task` връща `true`. Последното `true` потвърждава типа на грешката при `add(1)`; изходът не зависи от автоматичното освобождаване на паметта.
Свързани уроци
- JavaScript · Урок 30 · Средно · Версия: 3