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

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) // boolean

WeakSet.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

Източници