Set

Set-Objekte sind Sammlungen von Werten. Ein Wert im Set darf nur einmal vorkommen; er ist einzigartig in der Sammlung des Sets. Sie können durch die Elemente eines Sets in der Einfügereihenfolge iterieren. Die Einfügereihenfolge entspricht der Reihenfolge, in der jedes Element erfolgreich mittels der add()-Methode ins Set eingefügt wurde (das heißt, es gab kein identisches Element bereits im Set bei dem Aufruf von add()).

Die Spezifikation erfordert, dass Sets so implementiert werden, "dass sie im Durchschnitt Zugriffszeiten bieten, die sublinear zur Anzahl der Elemente in der Sammlung sind". Daher könnte es intern als Hashtabelle (mit O(1) Zugriff), Suchbaum (mit O(log(N)) Zugriff) oder einer anderen Datenstruktur dargestellt werden, solange die Komplexität besser als O(N) ist.

Die Wertgleichheit basiert auf dem SameValueZero-Algorithmus. (Früher wurde SameValue verwendet, das 0 und -0 als unterschiedlich behandelte. Überprüfen Sie die Browser-Kompatibilität.) Dies bedeutet, dass NaN als gleich zu NaN betrachtet wird (obwohl NaN !== NaN) und alle anderen Werte gemäß der ===-Operatorsemantik als gleich betrachtet werden.

Die Methode has überprüft, ob ein Wert im Set vorhanden ist, wobei ein Ansatz verwendet wird, der im Durchschnitt schneller ist als das Testen der meisten Elemente, die zuvor zum Set hinzugefügt wurden. Insbesondere ist sie im Durchschnitt schneller als die Methode Array.prototype.includes, wenn ein Array eine length hat, die der size eines Sets entspricht.

Das Set-Objekt bietet einige Methoden, die Ihnen ermöglichen, Sets wie bei mathematischen Operationen zu komponieren. Diese Methoden umfassen:

Methode	Rückgabetyp	Mathematisches Äquivalent	Venn-Diagramm
A.difference(B)	Set	$A\setminus B$
A.intersection(B)	Set	$A\cap B$
A.symmetricDifference(B)	Set	$(A\setminus B)\cup(B\setminus A)$
A.union(B)	Set	$A\cup B$
A.isDisjointFrom(B)	Boolean	$A\cap B = \empty$
A.isSubsetOf(B)	Boolean	$A\subseteq B$
A.isSupersetOf(B)	Boolean	$A\supseteq B$

Um sie allgemeiner anwendbar zu machen, akzeptieren diese Methoden nicht nur Set-Objekte, sondern alles, was Set-ähnlich ist.

Alle Set-Kompositionsmethoden erfordern, dass this eine tatsächliche Set-Instanz ist, aber ihre Argumente müssen nur set-ähnlich sein. Ein set-ähnliches Objekt ist ein Objekt, das Folgendes bereitstellt:

• Eine size-Eigenschaft, die eine Zahl enthält.
• Eine has()-Methode, die ein Element übernimmt und einen Boolean zurückgibt.
• Eine keys()-Methode, die einen Iterator der Elemente im Set zurückgibt.

Beispielsweise sind Map-Objekte set-ähnlich, weil sie ebenfalls size, has(), und keys() haben, sodass sie sich wie Mengen von Schlüsseln verhalten, wenn sie in Set-Methoden verwendet werden:

const a = new Set([1, 2, 3]);
const b = new Map([
  [1, "one"],
  [2, "two"],
  [4, "four"],
]);
console.log(a.union(b)); // Set(4) {1, 2, 3, 4}

Arrays sind nicht set-ähnlich, da sie keine has()-Methode oder die size-Eigenschaft haben und ihre keys()-Methode Indizes anstelle von Elementen produziert. WeakSet-Objekte sind ebenfalls nicht set-ähnlich, da sie keine keys()-Methode haben.

Set-ähnliche Objekte (oder "set-ähnliche Objekte" im Browser) sind Web API-Schnittstellen, die sich in vielen Aspekten wie ein Set verhalten.

Genau wie Set können die Elemente in der gleichen Reihenfolge iteriert werden, in der sie dem Objekt hinzugefügt wurden. Set-ähnliche Objekte und Set haben auch Eigenschaften und Methoden, die den gleichen Namen und das gleiche Verhalten teilen. Im Gegensatz zu Set erlauben sie jedoch nur einen spezifischen vordefinierten Typ für jeden Eintrag.

Die erlaubten Typen sind in der Spezifikation der IDL-Definition festgelegt. Zum Beispiel ist GPUSupportedFeatures ein Set-ähnliches Objekt, das Zeichenfolgen als Schlüssel/Wert verwenden muss. Dies ist in der Spezifikation der unteren IDL definiert:

interface GPUSupportedFeatures {
  readonly setlike<DOMString>;
};

Set-ähnliche Objekte sind entweder schreibgeschützt oder schreib-/lesbar (siehe das readonly Schlüsselwort in der oberen IDL).

• Schreibgeschützte Set-ähnliche Objekte haben die Eigenschaft size, und die Methoden: entries(), forEach(), has(), keys(), values(), und Symbol.iterator().
• Beschreibbare Set-ähnliche Objekte haben zusätzlich die Methoden: clear(), delete(), und add().

Die Methoden und Eigenschaften haben das gleiche Verhalten wie die entsprechenden Entitäten in Set, außer der Einschränkung auf die Typen des Eintrags.

Folgende sind Beispiele für schreibgeschützte Set-ähnliche Browser-Objekte:

• GPUSupportedFeatures
• XRAnchorSet

Folgende sind Beispiele für beschreibbare Set-ähnliche Browser-Objekte:

• CustomStateSet
• FontFaceSet
• Highlight

Set()

Erstellt ein neues Set-Objekt.

Set[Symbol.species]

Die Konstrukturfunktion, die verwendet wird, um abgeleitete Objekte zu erstellen.

Diese Eigenschaften sind auf Set.prototype definiert und werden von allen Set-Instanzen geteilt.

Set.prototype.constructor

Die Konstrukturfunktion, die das Instanzobjekt erstellt hat. Für Set-Instanzen ist der initiale Wert der Set-Konstruktor.

Set.prototype.size

Gibt die Anzahl der Werte im Set-Objekt zurück.

Set.prototype[Symbol.toStringTag]

Der initiale Wert der [Symbol.toStringTag]-Eigenschaft ist der String "Set". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Set.prototype.add()

Fügt ein neues Element mit einem angegebenen Wert in ein Set-Objekt ein, falls nicht bereits ein Element mit gleichem Wert im Set vorhanden ist.

Set.prototype.clear()

Entfernt alle Elemente aus dem Set-Objekt.

Set.prototype.delete()

Entfernt das mit dem Wert assoziierte Element und gibt einen Boolean zurück, der bestätigt, ob ein Element erfolgreich entfernt wurde oder nicht. Set.prototype.has(value) wird danach false zurückgeben.

Set.prototype.difference()

Nimmt ein Set und gibt ein neues Set zurück, das Elemente enthält, die sich in diesem Set befinden, aber nicht im angegebenen Set.

Set.prototype.entries()

Gibt ein neues Iterator-Objekt zurück, das ein Array von [value, value] für jedes Element im Set-Objekt in Einfügereihenfolge enthält. Dies ist dem Map-Objekt ähnlich, sodass der Schlüssel jedes Eintrags für ein Set der gleiche wie dessen Wert ist.

Set.prototype.forEach()

Ruft callbackFn einmal für jeden im Set-Objekt vorhandenen Wert in Einfügereihenfolge auf. Falls ein thisArg-Parameter angegeben wird, wird er als this-Wert für jeden Aufruf von callbackFn verwendet.

Set.prototype.has()

Gibt einen Boolean zurück, der bestätigt, ob ein Element mit dem gegebenen Wert im Set-Objekt vorhanden ist oder nicht.

Set.prototype.intersection()

Nimmt ein Set und gibt ein neues Set zurück, das Elemente enthält, die sowohl in diesem Set als auch im gegebenen Set sind.

Set.prototype.isDisjointFrom()

Nimmt ein Set und gibt einen Boolean zurück, der anzeigt, ob dieses Set keine gemeinsamen Elemente mit dem angegebenen Set hat.

Set.prototype.isSubsetOf()

Nimmt ein Set und gibt einen Boolean zurück, der anzeigt, ob alle Elemente dieses Sets im angegebenen Set sind.

Set.prototype.isSupersetOf()

Nimmt ein Set und gibt einen Boolean zurück, der anzeigt, ob alle Elemente des angegebenen Sets in diesem Set sind.

Set.prototype.keys()

Ein Alias für Set.prototype.values().

Set.prototype.symmetricDifference()

Nimmt ein Set und gibt ein neues Set zurück, das Elemente enthält, die entweder in diesem Set oder im angegebenen Set sind, aber nicht in beiden.

Set.prototype.union()

Nimmt ein Set und gibt ein neues Set zurück, das Elemente enthält, die entweder in diesem oder im angegebenen Set oder in beiden sind.

Set.prototype.values()

Gibt ein neues Iterator-Objekt zurück, das die Werte für jedes Element im Set-Objekt in Einfügereihenfolge liefert.

Set.prototype[Symbol.iterator]()

Gibt ein neues Iterator-Objekt zurück, das die Werte für jedes Element im Set-Objekt in Einfügereihenfolge liefert.

Die Iteration über ein Set besucht Elemente in Einfügereihenfolge.

for (const item of mySet1) {
  console.log(item);
}
// 1, "some text", { "a": 1, "b": 2 }, { "a": 1, "b": 2 }, 5

for (const item of mySet1.keys()) {
  console.log(item);
}
// 1, "some text", { "a": 1, "b": 2 }, { "a": 1, "b": 2 }, 5

for (const item of mySet1.values()) {
  console.log(item);
}
// 1, "some text", { "a": 1, "b": 2 }, { "a": 1, "b": 2 }, 5

// key and value are the same here
for (const [key, value] of mySet1.entries()) {
  console.log(key);
}
// 1, "some text", { "a": 1, "b": 2 }, { "a": 1, "b": 2 }, 5

// Convert Set object to an Array object, with Array.from
const myArr = Array.from(mySet1); // [1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}, 5]

// the following will also work if run in an HTML document
mySet1.add(document.body);
mySet1.has(document.querySelector("body")); // true

// converting between Set and Array
const mySet2 = new Set([1, 2, 3, 4]);
console.log(mySet2.size); // 4
console.log([...mySet2]); // [1, 2, 3, 4]

// intersect can be simulated via
const intersection = new Set([...mySet1].filter((x) => mySet2.has(x)));

// difference can be simulated via
const difference = new Set([...mySet1].filter((x) => !mySet2.has(x)));

// Iterate set entries with forEach()
mySet2.forEach((value) => {
  console.log(value);
});
// 1
// 2
// 3
// 4

• Polyfill von Set in core-js
• es-shims Polyfill von Set
• Map
• WeakMap
• WeakSet