Set.prototype.difference()

Syntax

difference(other)

Parameter

other

Ein Set Objekt oder set-ähnliches Objekt.

Rückgabewert

Ein neues Set Objekt, das Elemente aus diesem Set enthält, die nicht im other Set sind.

Beschreibung

In mathematischer Notation ist Differenz definiert als:

Und mit Venn-Diagramm:

difference() akzeptiert set-ähnliche Objekte als den other Parameter. Es erfordert, dass this eine tatsächliche Set Instanz ist, da es direkt auf die zugrundeliegenden Daten in this zugreift, ohne Benutzercode auszulösen. Dann hängt sein Verhalten von den Größen von this und other ab:

• Wenn es mehr Elemente in this als other.size gibt, dann iteriert es über other, indem es dessen keys() Methode aufruft und ein neues Set mit allen Elementen in this erstellt, die in other nicht gefunden werden.
• Andernfalls iteriert es über die Elemente in this und erstellt ein neues Set mit allen Elementen e in this, für die other.has(e) einen falsy Wert zurückgibt.

Die Reihenfolge der Elemente im zurückgegebenen Set ist dieselbe wie in this.

Beispiele

Nutzung von difference()

Das folgende Beispiel berechnet die Differenz zwischen der Menge der ungeraden Zahlen (<10) und der Menge der perfekten Quadrate (<10). Das Ergebnis ist die Menge der ungeraden Zahlen, die keine perfekten Quadrate 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 von Set.prototype.difference in core-js
• es-shims Polyfill von Set.prototype.difference
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()