CKTIS / JavaScript
WeakSet: Elemente mit has() prüfen und mit add() hinzufügen
Mit `has()` prüfst du, ob ein Wert in einem `WeakSet` enthalten ist, und mit `add()` fügst du ihn hinzu. Entscheidend ist die Identität; die Sammlung hält ihre Elemente nicht am Leben.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const seen = new WeakSet();
seen.has(value);
seen.add(value);WeakSet.prototype.has und WeakSet.prototype.add sind zwei Instanzmethoden. seen.has(value) gibt true zurück, wenn der Wert enthalten ist, andernfalls false. seen.add(value) fügt den Wert nur hinzu, wenn er noch fehlt, und gibt dieselbe WeakSet-Instanz zurück. Erneutes Hinzufügen erzeugt kein Duplikat. Der Rückgabewert erlaubt es, add()-Aufrufe zu verketten.
Entscheidend ist die Identität, nicht der Inhalt: Zwei Referenzen auf dasselbe Objekt bezeichnen dasselbe Element, zwei getrennte Objekte mit identischen Eigenschaften dagegen nicht. ECMAScript 2024 erlaubt Objekte (einschließlich Funktionen) und nicht registrierte Symbole, etwa solche aus Symbol(). Bei einem Symbol aus Symbol.for(), einer Zahl, einem String oder null gibt has() den Wert false zurück, während add() einen TypeError auslöst. Beide Methoden lösen auch dann einen TypeError aus, wenn this keine WeakSet-Instanz ist, etwa beim Aufruf einer losgelösten Methode ohne Bindung an die Instanz.
Die Mitgliedschaft allein verhindert nicht, dass die Garbage Collection einen Wert freigibt. Der Zeitpunkt der Freigabe ist nicht vorhersehbar. Ein WeakSet hat kein size und lässt sich nicht iterieren. Verwende es, um bereits verarbeitete Objekte zu markieren, wenn du sie später nicht auflisten musst. Wähle Set, wenn du Iteration, eine Größenangabe oder Elemente wie Zahlen und Strings brauchst.
Die Unterstützung für Symbole kann je nach Laufzeitumgebung variieren. Wenn du darauf angewiesen bist, teste add() mit einem durch Symbol() erzeugten Wert in der Zielumgebung. Es reicht nicht, nur zu prüfen, ob WeakSet vorhanden ist.
Beispiele
{
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);
}
}Ergebnis
false true true false false TypeError
Der erste `has()`-Aufruf ergibt `false`. Die beiden `add()`-Aufrufe lassen sich verketten, weil die Methode dieselbe Instanz zurückgibt. `alias` verweist auf das eingefügte Objekt; ein neues Objekt mit derselben `id` ist nicht identisch. Für die Zahl `1` ergibt die Prüfung `false`, und das Einfügen löst den abgefangenen `TypeError` aus.
Zugehörige Lektionen
- JavaScript · Lektion 17 · Fortgeschritten · Version: 4
- JavaScript · Lektion 43 · Fortgeschritten · Version: 4
- JavaScript · Lektion 45 · Fortgeschritten · Version: 4
- JavaScript · Lektion 40 · Mittlere Stufe · Version: 3