Set.prototype.difference()

Syntax

difference(other)

Parameter

other

Ein Set-Objekt oder ein set-artiges Objekt.

Rückgabewert

Ein neues Set-Objekt mit den Elementen dieser Menge, die nicht in der Menge other enthalten sind.

Beschreibung

In mathematischer Schreibweise ist die Differenz wie folgt definiert:

Als Venn-Diagramm dargestellt:

difference() akzeptiert set-artige Objekte als Parameter other. this muss eine tatsächliche Set-Instanz sein, da die Methode direkt auf die in this gespeicherten Daten zugreift, ohne benutzerdefinierten Code aufzurufen. Das weitere Verhalten hängt von der Größe von this und other ab:

• Wenn this mehr Elemente als other.size enthält, durchläuft die Methode other durch Aufruf von dessen keys()-Methode und erstellt eine neue Menge mit allen Elementen aus this, die nicht in other vorkommen.
• Andernfalls durchläuft sie die Elemente in this und erstellt eine neue Menge mit allen Elementen e aus this, für die other.has(e) einen falsy-Wert zurückgibt.

Die Reihenfolge der Elemente in der zurückgegebenen Menge entspricht der Reihenfolge in this.

Beispiele

difference() verwenden

Das folgende Beispiel berechnet die Differenz zwischen der Menge der ungeraden Zahlen (<10) und der Menge der Quadratzahlen (<10). Das Ergebnis ist die Menge der ungeraden Zahlen, die keine Quadratzahlen sind.

const odds = new Set([1, 3, 5, 7, 9]);
const squares = new Set([1, 4, 9]);
console.log(odds.difference(squares)); // Set(3) { 3, 5, 7 }

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für Set.prototype.difference in core-js
• Polyfill für Set.prototype.difference von es-shims
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()