CKTIS / JavaScript
WeakSet: preverjanje in dodajanje elementov z metodama has() in add()
Z metodo `has()` preveriš, ali vrednost pripada zbirki `WeakSet`, z metodo `add()` pa jo dodaš. Članstvo temelji na identiteti vrednosti, zbirka sama pa je ne ohranja pri življenju.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has in WeakSet.prototype.add sta metodi primerka. seen.has(value) vrne true, če je vrednost v zbirki, sicer pa false. seen.add(value) vstavi vrednost, če je še ni v zbirki, in vrne isti primerek WeakSet. Ponovno dodajanje ne ustvari dvojnika, vrnjena vrednost pa omogoča veriženje klicev add().
Pri preverjanju članstva šteje identiteta, ne vsebina: dva sklica na isti objekt označujeta isti element, dva ločena objekta z enakimi lastnostmi pa se ne ujemata. ECMAScript 2024 dopušča objekte (tudi funkcije) in neregistrirane simbole, na primer tiste, ustvarjene s Symbol(). Za simbol iz Symbol.for(), število, niz ali null metoda has() vrne false, metoda add() pa sproži TypeError. Obe metodi sprožita TypeError tudi, če this ni primerek WeakSet, na primer ob samostojnem klicu shranjene metode brez vezave na primerek.
Članstvo samo po sebi ne prepreči, da bi zbiralnik smeti sprostil pomnilnik, ki ga zaseda vrednost. Kdaj se bo to zgodilo, ni mogoče napovedati. WeakSet nima lastnosti size in po njem ni mogoče iterirati. Uporabi ga za označevanje že obdelanih objektov, če jih pozneje ne potrebuješ na seznamu. Izberi Set, če potrebuješ iteracijo, velikost zbirke ali elemente, kot so števila in nizi.
Podpora za simbole se lahko razlikuje med izvajalnimi okolji. Če jo potrebuješ, v ciljnem okolju preizkusi add() z vrednostjo, ustvarjeno s Symbol(); preverjanje obstoja WeakSet ne zadostuje.
Primeri
{
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);
}
}Rezultat
false true true false false TypeError
Prvi klic `has()` vrne `false`. Klica `add()` lahko verižiš, ker metoda vrne isti primerek. `alias` se sklicuje na vstavljeni objekt; nov objekt z enakim `id` se z njim ne ujema. Za število `1` preverjanje vrne `false`, vstavljanje pa sproži prestreženi `TypeError`.
Povezane lekcije
- JavaScript · Lekcija 17 · Napredna · Različica: 4
- JavaScript · Lekcija 43 · Napredna · Različica: 4
- JavaScript · Lekcija 45 · Napredna · Različica: 4
- JavaScript · Lekcija 40 · Srednja · Različica: 3