CKTIS / JavaScript
WeakSet: Elemente prüfen, hinzufügen und entfernen
Mit `has()` prüfst du, ob ein Wert enthalten ist. Mit `add()` fügst du ihn hinzu, mit `delete()` entfernst du ihn. Die Methoden unterscheiden sich beim Rückgabewert und beim Umgang mit ungültigen Werten.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
weakSet.has(value) // boolean
weakSet.add(value) // the same WeakSet instance
weakSet.delete(value) // booleanWeakSet.prototype.has/add/delete steht für drei Methoden auf WeakSet.prototype, nicht für eine einzelne Methode. Rufe sie auf einer Instanz auf, etwa mit seen.has(value). Fehlt beim Aufruf eine WeakSet-Instanz als this, wird ein TypeError ausgelöst. Das passiert auch, wenn du die Methode von der Instanz löst und als gewöhnliche Funktion aufrufst.
has(value) gibt true zurück, wenn der Wert enthalten ist, sonst false; die Menge bleibt unverändert. add(value) fügt den Wert nur hinzu, wenn er fehlt, und gibt bei Erfolg dieselbe Instanz zurück. Dadurch lassen sich Aufrufe verketten. delete(value) gibt nur dann true zurück, wenn ein Element entfernt wurde, sonst false. Für die Zugehörigkeit zählt die Identität, nicht der Inhalt: Zwei separat erzeugte Objekte { id: 1 } sind verschiedene Elemente.
ECMAScript 2024 erlaubt Objekte (einschließlich Funktionen) und nicht registrierte Symbole, etwa Symbol(). Symbole aus der globalen Registrierung, die Symbol.for() zurückgibt, und andere primitive Werte wie 1 und null sind nicht erlaubt. Bei einem ungültigen Wert löst add() einen TypeError aus; has() und delete() geben dagegen false zurück. Ältere Laufzeitumgebungen akzeptieren möglicherweise nur Objekte. Prüfe daher die Symbolunterstützung in deiner Zielumgebung.
Ein Eintrag in einem WeakSet hält einen Wert nicht von sich aus am Leben. Ist der Wert nicht mehr über starke Referenzen erreichbar, kann ihn die Speicherbereinigung freigeben; verlasse dich nicht auf den Zeitpunkt. Ein WeakSet ist nicht iterierbar und hat keine Eigenschaft size. Damit kannst du bereits verarbeitete Objekte markieren. Wenn du Elemente durchlaufen oder zählen musst, verwende Set, das seine Elemente über starke Referenzen hält.
Beispiele
{
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);
}
}Ergebnis
true true false true false false false false true
Auch beim doppelten Hinzufügen von `task` ist der Rückgabewert `seen`. `lookalike` hat denselben Inhalt, ist aber nicht enthalten. Nur das erste Entfernen von `task` liefert `true`. Das letzte `true` bestätigt den Fehlertyp bei `add(1)`; die Ausgabe hängt nicht von der Speicherbereinigung ab.
Zugehörige Lektionen
- JavaScript · Lektion 30 · Mittlere Stufe · Version: 3