CKTIS / JavaScript
WeakSet: проверка и добавяне на елементи с has() и add()
Използвай `has()`, за да провериш дали дадена стойност принадлежи на `WeakSet`, и `add()`, за да я добавиш. Принадлежността зависи от идентичността, а колекцията сама не задържа стойността в паметта.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has и WeakSet.prototype.add са два метода на инстанцията. seen.has(value) връща true, ако стойността присъства, и false в противен случай. seen.add(value) добавя стойността, ако още я няма, и връща същата инстанция на WeakSet. Повторното добавяне не създава дубликат, а върнатата инстанция позволява последователно извикване на add() във верига.
Проверката е по идентичност, а не по съдържание: две референции към един и същ обект обозначават един и същ елемент, но два отделни обекта с еднакви свойства не съвпадат. ECMAScript 2024 приема обекти (включително функции) и нерегистрирани символи, например създадените чрез Symbol(). За символ от Symbol.for(), число, низ или null методът has() връща false, а add() хвърля TypeError. И двата метода хвърлят TypeError и когато this не е инстанция на WeakSet, например при извикване на отделен метод, без да е обвързан с инстанцията.
Самата принадлежност не пречи на механизма за автоматично управление на паметта да освободи паметта, заета от стойността. Не може да се предвиди кога ще стане това. WeakSet няма свойство size и не поддържа обхождане на елементите си. Използвай го, за да отбелязваш вече обработени обекти, ако няма да ти трябва списък с тях. Избери Set, ако ти трябват обхождане, брой елементи или стойности като числа и низове.
Поддръжката на символи може да се различава според средата за изпълнение. Ако разчиташ на нея, изпробвай add() със стойност, създадена чрез Symbol(), в целевата среда. Не е достатъчно само да провериш дали съществува WeakSet.
Примери
{
const seen = new WeakSet();
const item = { id: 1 };
const alias = item;
console.log(seen.has(item));
console.log(seen.add(item).add(item) === seen);
console.log(seen.has(alias));
console.log(seen.has({ id: 1 }));
console.log(seen.has(1));
try {
seen.add(1);
} catch (error) {
console.log(error.name);
}
}Резултат
false true true false false TypeError
Първото извикване на `has()` връща `false`. Двете извиквания на `add()` могат да се свържат във верига, защото методът връща същата инстанция. `alias` сочи към добавения обект, а нов обект със същото `id` не съвпада с него. За числото `1` проверката връща `false`, а добавянето хвърля прихванатия `TypeError`.
Свързани уроци
- JavaScript · Урок 17 · Напреднало · Версия: 4
- JavaScript · Урок 43 · Напреднало · Версия: 4
- JavaScript · Урок 45 · Напреднало · Версия: 4
- JavaScript · Урок 40 · Средно · Версия: 3