Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

WeakSet — množica s šibkimi referencami

WeakSet vsebuje enolične objekte in neregistrirane simbole, ne da bi jih ohranjal pri življenju zgolj zaradi članstva v množici. Ponuja add, has in delete, ne omogoča pa iteriranja po elementih ali pridobitve njihovega števila.

Različica: 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 se uporablja za sledenje vrednostim, na primer že obdelanim objektom. Objekti se razlikujejo po identiteti, ne po vsebini: dva ločena objekta { id: 1 } sta različna elementa. new WeakSet(iterable) doda vrednosti iz podanega iterabilnega objekta; konstruktor zahteva new.

WeakSet.prototype.add(value) doda element, prezre podvojene vrednosti in vrne isto množico, zato lahko klice verižiš. WeakSet.prototype.has(value) vrne podatek o članstvu kot boolean. WeakSet.prototype.delete(value) vrne true, če odstrani obstoječi element, sicer pa false.

Dovoljeni so objekti, vključno s funkcijami, in simboli, ki niso registrirani prek Symbol.for. Pri nepodprtih vrednostih, kot so števila, nizi, null ali rezultat Symbol.for, add sproži TypeError, medtem ko has in delete vrneta false. Podpora za simbole je bila dodana v ECMAScript 2023; starejši pogoni morda sprejemajo samo objekte. Specifikacija jezika ni tabela združljivosti brskalnikov: preveri podporo te funkcije v ciljnem okolju.

Za razliko od Set WeakSet elementov ne ohranja pri življenju zgolj zaradi članstva. Čas zbiranja smeti ni zagotovljen. Na voljo niso size, iteracija, forEach ali clear; za preverjanje članstva moraš imeti vrednost, ki jo preverjaš. Izberi Set, če moraš našteti elemente ali poznati njihovo število.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri