WeakSet
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.
* Some parts of this feature may have varying levels of support.
Ein WeakSet ist eine Sammlung von speicherbereinigbaren Werten, einschließlich Objekten und nicht-registrierten Symbolen. Ein Wert im WeakSet kann nur einmal vorkommen. Er ist einzigartig in der Sammlung des WeakSet.
Beschreibung
Werte von WeakSets müssen speicherbereinigbar sein. Die meisten primitiven Datentypen können beliebig erstellt werden und haben keine Lebensdauer, sodass sie nicht gespeichert werden können. Objekte und nicht-registrierte Symbole können gespeichert werden, da sie speicherbereinigbar sind.
Die Hauptunterschiede zum Set Objekt sind:
-
WeakSets sind Sammlungen von nur Objekten und Symbolen. Sie können keine beliebigen Werte enthalten, wie esSets können. -
Das
WeakSetist schwach, was bedeutet, dass Referenzen auf Objekte in einemWeakSetschwach gehalten werden. Wenn keine anderen Referenzen auf einen imWeakSetgespeicherten Wert existieren, können diese Werte speicherbereinigt werden.Hinweis: Dies bedeutet auch, dass es keine Liste der aktuell in der Sammlung gespeicherten Werte gibt.
WeakSetssind nicht aufzählbar.
Anwendungsfall: Erkennung von zyklischen Referenzen
Funktionen, die sich selbst rekursiv aufrufen, benötigen eine Möglichkeit, sich gegen zyklische Datenstrukturen abzusichern, indem sie verfolgen, welche Objekte bereits verarbeitet wurden.
WeakSets sind ideal für diesen Zweck:
// Execute a callback on everything stored inside an object
function execRecursively(fn, subject, _refs = new WeakSet()) {
// Avoid infinite recursion
if (_refs.has(subject)) {
return;
}
fn(subject);
if (typeof subject === "object" && subject) {
_refs.add(subject);
for (const key in subject) {
execRecursively(fn, subject[key], _refs);
}
_refs.delete(subject);
}
}
const foo = {
foo: "Foo",
bar: {
bar: "Bar",
},
};
foo.bar.baz = foo; // Circular reference!
execRecursively((obj) => console.log(obj), foo);
Hier wird bei der ersten Ausführung ein WeakSet erstellt und bei jedem folgenden Funktionsaufruf (unter Verwendung des internen Parameters _refs) weitergegeben.
Die Anzahl der Objekte oder deren Traversierreihenfolge ist unerheblich, daher ist ein WeakSet geeigneter (und leistungsfähiger) als ein Set zum Verfolgen von Objektreferenzen, insbesondere wenn eine sehr große Anzahl von Objekten beteiligt ist.
Konstruktor
WeakSet()-
Erstellt ein neues
WeakSetObjekt.
Instanz-Eigenschaften
Diese Eigenschaften sind auf WeakSet.prototype definiert und werden von allen WeakSet Instanzen geteilt.
WeakSet.prototype.constructor-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
WeakSetInstanzen ist der Anfangswert derWeakSetKonstruktor. WeakSet.prototype[Symbol.toStringTag]-
Der Anfangswert der
[Symbol.toStringTag]Eigenschaft ist der String"WeakSet". Diese Eigenschaft wird inObject.prototype.toString()verwendet.
Instanz-Methoden
WeakSet.prototype.add()-
Fügt
valuezumWeakSetObjekt hinzu. WeakSet.prototype.delete()-
Entfernt
valueaus demWeakSet.WeakSet.prototype.has(value)wird anschließendfalsezurückgeben. WeakSet.prototype.has()-
Gibt einen booleschen Wert zurück, der angibt, ob
valueimWeakSetObjekt vorhanden ist oder nicht.
Beispiele
Verwendung des WeakSet Objekts
const ws = new WeakSet();
const foo = {};
const bar = {};
ws.add(foo);
ws.add(bar);
ws.has(foo); // true
ws.has(bar); // true
ws.delete(foo); // removes foo from the set
ws.has(foo); // false, foo has been removed
ws.has(bar); // true, bar is retained
Beachten Sie, dass foo !== bar. Obwohl sie ähnliche Objekte sind, sind sie nicht dasselbe Objekt. Und so werden beide zur Menge hinzugefügt.
Spezifikationen
| Specification |
|---|
| ECMAScript Language Specification # sec-weakset-objects |
Browser-Kompatibilität
BCD tables only load in the browser