WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.intersection — gemeinsame Set-Werte

Die Methode intersection(other) gibt ein neues Set mit den Werten zurück, die in beiden Sammlungen vorkommen. Die Reihenfolge des Ergebnisses hängt von den Größen der Operanden ab; other kann auch ein Objekt mit set-ähnlicher Schnittstelle sein.

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

set.intersection(other) berechnet die Schnittmenge und gibt ein neues Set mit den Werten zurück, die in beiden Sammlungen vorkommen. Bei gewöhnlichen Sets wird keine der Eingaben verändert. Die Methode ist Bestandteil von ECMAScript 2025 und keine Browser-API. Die Spezifikation allein belegt nicht die Unterstützung in einem bestimmten Browser; prüfe vor der Verwendung typeof Set.prototype.intersection === "function". Node 24 in einem Repository beweist keine Browser-Unterstützung.

Der Empfänger set muss ein tatsächliches Set-Objekt sein. Das Argument other kann ein Set oder ein set-ähnliches Objekt sein: Es muss ein gültiges size sowie aufrufbare Methoden has und keys bereitstellen. Auch ein Map ist geeignet; seine Schlüssel werden als Elemente behandelt. Iterierbarkeit allein genügt nicht: Ein gewöhnliches Array implementiert diese Schnittstelle nicht. Ein ungültiger Empfänger führt zu einem TypeError.

Bei gewöhnlichen Sets durchläuft die Methode das kleinere Set und bewahrt dessen Einfügereihenfolge. Bei gleicher Größe verwendet sie die Reihenfolge von set. Daher können a.intersection(b) und b.intersection(a) dieselben Elemente in unterschiedlicher Reihenfolge enthalten. Bei gewöhnlichen Sets folgt die Prüfung der Elementzugehörigkeit der Semantik von SameValueZero: NaN entspricht NaN, +0 und -0 gelten als gleich, und Objekte müssen dieselbe Identität haben. Ist die Größe des Empfängers kleiner als oder gleich der von other angegebenen Größe, prüft die Methode die Elementzugehörigkeit durch einen Aufruf von other.has. Eine benutzerdefinierte has-Methode muss SameValueZero nicht befolgen und kann beispielsweise unterschiedliche Objekte als gleichwertig behandeln.

Im Beispiel ist right kleiner, daher lautet die Reihenfolge des Ergebnisses [3,2]; die Größen der Eingaben bleiben unverändert. Benutzerdefinierte Getter sowie die Methoden has und keys von other können Code ausführen, Daten verändern oder Ausnahmen auslösen. Gehe in diesem Fall nicht davon aus, dass der Vorgang frei von Seiteneffekten ist.

Beispiele

const left = new Set([1, 2, 3, 4]);
const right = new Set([3, 2]);
const common = left.intersection(right);

console.log(JSON.stringify([...common]));
console.log(left.size, right.size);

Ergebnis

[3,2]
4 2

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