WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

WeakSet — eine Menge mit schwachen Referenzen

WeakSet enthält eindeutige Objekte und nicht registrierte Symbole, ohne sie allein durch ihre Zugehörigkeit am Leben zu halten. Es bietet add, has und delete, erlaubt aber weder die Iteration über Elemente noch das Auslesen ihrer Anzahl.

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

Syntax

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

WeakSet dient dazu, Werte nachzuverfolgen, etwa bereits verarbeitete Objekte. Objekte werden anhand ihrer Identität und nicht ihres Inhalts unterschieden: Zwei separate Objekte { id: 1 } sind verschiedene Elemente. new WeakSet(iterable) fügt Werte aus dem übergebenen iterierbaren Objekt hinzu; der Konstruktor erfordert new.

WeakSet.prototype.add(value) fügt ein Element hinzu, ignoriert Duplikate und gibt dieselbe Menge zurück, sodass sich Aufrufe verketten lassen. WeakSet.prototype.has(value) gibt die Zugehörigkeit als boolean zurück. WeakSet.prototype.delete(value) gibt true zurück, wenn ein vorhandenes Element entfernt wurde, andernfalls false.

Zulässig sind Objekte, einschließlich Funktionen, sowie Symbole, die nicht über Symbol.for registriert wurden. Bei unzulässigen Werten wie Zahlen, Zeichenketten, null oder einem Ergebnis von Symbol.for löst add einen TypeError aus, während has und delete false zurückgeben. Die Unterstützung für Symbole wurde mit ECMAScript 2023 hinzugefügt; ältere Engines akzeptieren möglicherweise nur Objekte. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle: Prüfe die Unterstützung dieser Funktion in deiner Zielumgebung.

Anders als Set hält WeakSet Elemente nicht allein durch ihre Zugehörigkeit am Leben. Für die Garbage Collection gibt es keinen garantierten Zeitpunkt. size, Iteration, forEach und clear sind nicht verfügbar; für eine Mitgliedschaftsprüfung musst du den geprüften Wert besitzen. Wähle Set, wenn du Elemente aufzählen oder ihre Anzahl kennen musst.

Beispiele

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

Ergebnis

true
false
true
true
true
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen