Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

WeakSet — skup sa slabim referencama

WeakSet sadrži jedinstvene objekte i neregistrirane simbole, a ne održava ih na životu samo zbog članstva u skupu. Omogućuje add, has i delete, ali ne i iteriranje po elementima ili dohvaćanje njihova broja.

Verzija: WeakSet was introduced in ECMAScript 2015 (ES2015). Support for non-registered symbols as elements was added in ECMAScript 2023 (ES2023).

Sintaksa

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

WeakSet služi za praćenje vrijednosti, primjerice već obrađenih objekata. Objekti se razlikuju prema identitetu, a ne sadržaju: dva zasebna objekta { id: 1 } različiti su elementi. new WeakSet(iterable) dodaje vrijednosti iz predanog iterabilnog objekta; konstruktor zahtijeva new.

WeakSet.prototype.add(value) dodaje element, zanemaruje duplikate i vraća isti skup, što omogućuje ulančavanje poziva. WeakSet.prototype.has(value) vraća podatak o članstvu kao boolean. WeakSet.prototype.delete(value) vraća true ako je uklonio postojeći element, a inače false.

Dopušteni su objekti, uključujući funkcije, i simboli koji nisu registrirani pomoću Symbol.for. Za nepodržane vrijednosti, poput brojeva, nizova, null ili rezultata Symbol.for, add izbacuje TypeError, dok has i delete vraćaju false. Podrška za simbole dodana je u ECMAScript 2023; stariji pogoni možda prihvaćaju samo objekte. Jezična specifikacija nije tablica kompatibilnosti preglednika: provjeri podršku za ovu značajku u ciljnom okruženju.

Za razliku od Set, WeakSet ne održava elemente na životu samo zbog njihova članstva. Vrijeme prikupljanja smeća nije zajamčeno. Nema size, iteracije, forEach ni clear; za provjeru članstva moraš imati vrijednost koju provjeravaš. Odaberi Set ako trebaš izlistati elemente ili znati njihov broj.

Primjeri

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));

Rezultat

true
false
true
true
true
false
false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori