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

CKTIS / JavaScript

WeakSet — множество със слаби препратки

WeakSet съдържа уникални обекти и нерегистрирани символи, без да ги поддържа живи само заради членството им в множеството. Предоставя add, has и delete, но не позволява обхождане на елементите или проверка на броя им.

Версия: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Синтаксис

new WeakSet()
new WeakSet(iterable)
weakSet.add(value)
weakSet.has(value)
weakSet.delete(value)

WeakSet служи за проследяване на стойности, например вече обработени обекти. Обектите се различават по идентичност, а не по съдържание: два отделни обекта { id: 1 } са различни елементи. new WeakSet(iterable) добавя стойностите от подадения итерируем обект; конструкторът изисква new.

WeakSet.prototype.add(value) добавя елемент, игнорира дубликатите и връща същото множество, което позволява верижно извикване. WeakSet.prototype.has(value) връща информация за членството като boolean. WeakSet.prototype.delete(value) връща true, ако е премахнал съществуващ елемент, а в противен случай — false.

Разрешени са обекти, включително функции, и символи, които не са регистрирани чрез Symbol.for. За неподдържани стойности, като числа, низове, null или резултат от Symbol.for, add хвърля TypeError, докато has и delete връщат false. Поддръжката на символи е добавена в ECMAScript 2023; по-старите среди може да приемат само обекти. Езиковата спецификация не е таблица за съвместимост на браузърите: провери поддръжката на тази функционалност в целевата среда.

За разлика от Set, WeakSet не поддържа елементите живи само заради членството им. Няма гарантиран момент за събиране на боклука. Не са налични size, итерация, forEach или clear; за да провериш членството, трябва да разполагаш със съответната стойност. Избери Set, ако трябва да изброяваш елементите или да знаеш броя им.

Примери

const first = { id: 1 };
const second = { id: 1 };
const seen = new WeakSet([first]);

console.log(seen.has(first));
console.log(seen.has(second));
console.log(seen.add(second) === seen);
console.log(seen.has(second));
console.log(seen.delete(first));
console.log(seen.delete(first));
console.log(seen.has(first));

Резултат

true
false
true
true
true
false
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници