WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.symmetricDifference — symmetrische Differenz von Mengen

Bleiben die Eingabeelemente während des Aufrufs unverändert, gibt symmetricDifference() ein neues Set mit Werten zurück, die in genau einer der beiden Mengen vorkommen. Die Methode selbst verändert die Eingabemengen nicht.

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.symmetricDifference(other)

Bleiben die Eingabeelemente während des Aufrufs unverändert, gibt a.symmetricDifference(b) ein neues Set mit Werten zurück, die zu a oder b, aber nicht zu beiden gehören. Bei einem mengenähnlichen Argument gelten die von keys() gelieferten Werte als dessen Elemente. Anders als eine einseitige Differenz berücksichtigt die symmetrische Differenz Elemente, die jeweils nur auf einer Seite vorkommen. Die Methode selbst verändert die Eingabemengen nicht.

Der this-Empfänger muss ein tatsächliches Set-Objekt sein. Das Argument other kann ein mengenähnliches Objekt sein: Es muss die Eigenschaft size sowie aufrufbare Methoden has und keys bereitstellen. Die Umwandlung von size in eine Zahl darf nicht NaN ergeben, und das Ergebnis darf nach dem Abschneiden der Nachkommastellen in Richtung null nicht negativ sein. Daher ist -0.5 als size zulässig, wenn die übrigen Anforderungen der Schnittstelle erfüllt sind. Der Algorithmus prüft diese Schnittstelle, bezieht die Werte jedoch über keys() und nicht über has(). Eine Map erfüllt diese Anforderungen; ihre Schlüssel gelten hier als Elemente. Ein gewöhnliches Array erfüllt die Schnittstelle nicht. Eigene Zugriffseigenschaften und Methoden des Arguments können Nebenwirkungen haben.

Der Algorithmus kopiert die Daten des Empfängers vor dem ersten Schritt des Iterators des Arguments. Für jeden gelieferten Schlüssel prüft er jedoch, ob dieser im aktuellen Empfänger enthalten ist, nicht in der Kopie. Ändert der Iterator den Inhalt des Empfängers, muss das Ergebnis weder der symmetrischen Differenz zwischen den gelieferten Schlüsseln und dem ursprünglichen Inhalt noch derjenigen mit dem endgültigen Inhalt des Empfängers entsprechen.

Bei unveränderten Eingaben behält das Ergebnis zuerst die Reihenfolge der Werte bei, die nur im Empfänger vorkommen, und danach die Reihenfolge der Werte, die nur in other vorkommen, wie von keys() geliefert. Der Vergleich folgt SameValueZero: NaN entspricht NaN, +0 und -0 sind gleichwertig, und Objekte werden anhand ihrer Identität statt ihres Inhalts verglichen.

Die Methode ist Bestandteil von ECMAScript 2025 und keine eigenständige Web API. Die zitierte Spezifikation enthält keine Browser-Kompatibilitätstabelle. Prüfen Sie vor der Bereitstellung typeof Set.prototype.symmetricDifference === "function" in der Zielumgebung. Node 24 im Repository belegt keine Browser-Unterstützung.

Beispiele

const a = new Set([1, 2, 3]);
const b = new Set([3, 4, 2, 5]);
const result = a.symmetricDifference(b);

console.log(JSON.stringify([...result]));
console.log(JSON.stringify([...a]));
console.log(JSON.stringify([...b]));

Ergebnis

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

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