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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- ECMAScript® Language Specification
- ECMAScript® Language Specification — Keyed Collections
- ECMAScript® 2023 Language Specification — Keyed Collections
- ECMAScript® 2026 Language Specification — Executable Code and Execution Contexts
- Official reference — developer.mozilla.org: WeakSet / has
- Official reference — developer.mozilla.org: WeakSet / add
- Official reference — tc39.es: ecma262