WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.difference — Mengendifferenz

Die Methode difference() gibt ein neues Set mit den Elementen der aufrufenden Menge zurück, die in der anderen Menge nicht enthalten sind. Sie behält deren Reihenfolge bei und verändert die Eingabemengen nicht selbst.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

set.difference(other)

Set.prototype.difference berechnet die Mengendifferenz: a.difference(b) enthält die Elemente von a, die nicht in b enthalten sind. Die Reihenfolge der Operanden ist wichtig — es handelt sich nicht um die symmetrische Differenz. Das Ergebnis ist ein neues Set, das die Einfügereihenfolge der verbleibenden Elemente von a beibehält; die Operation selbst verändert die Eingabemengen nicht.

Der this-Empfänger muss ein tatsächliches Set-Objekt sein. Das Argument other kann eine Menge oder ein mengenähnliches Objekt sein: Es muss einen gültigen size-Wert sowie aufrufbare Methoden has() und keys() bereitstellen. Map erfüllt dieses Protokoll; verglichen werden dessen Schlüssel. Allein iterierbar zu sein genügt nicht: Ein Array muss zuerst an new Set(...) übergeben werden.

Bei gewöhnlichen Mengen gilt der Gleichheitsvergleich SameValueZero: NaN entspricht NaN, +0 und -0 sind gleichwertig, und Objekte werden nach Identität statt nach Inhalt verglichen. Je nach Größe verwendet der Algorithmus other.has() oder durchläuft other.keys(). Benutzerdefinierte Methoden und Getter können daher Nebenwirkungen auslösen; es sollte nicht angenommen werden, dass ihre Aufrufreihenfolge unabhängig von der Größe ist.

Die Methode gehört zu ECMAScript 2025, nicht zu den Web APIs. Prüfe bei der Bereitstellung typeof Set.prototype.difference === "function" in der Zielumgebung. Die Spezifikation ist keine Tabelle zur Browserunterstützung, und dass Node 24 in einem Repository vorhanden ist, belegt keine Browserunterstützung.

Beispiele

const available = new Set([3, 1, 2]);
const reserved = new Set([1, 4]);
const remaining = available.difference(reserved);

console.log(JSON.stringify([...remaining]));
console.log(JSON.stringify([...available]));
console.log(JSON.stringify([...reserved]));

Ergebnis

[3,2]
[3,1,2]
[1,4]

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