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

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

Източници