WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.isDisjointFrom — prüfen, ob Mengen disjunkt sind

Set.prototype.isDisjointFrom prüft, ob eine Menge keine gemeinsamen Elemente mit einer anderen Menge oder einem mengenähnlichen Objekt hat. Die Methode gibt einen booleschen Wert zurück, statt eine neue Menge zu erstellen.

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

set.isDisjointFrom(other) gibt true zurück, wenn die Mengen keine gemeinsamen Elemente haben, und false, sobald ein gemeinsames Element gefunden wird. Bei gewöhnlichen Set-Objekten ist eine leere Menge zu jeder Menge disjunkt, auch zu einer leeren. Die Methode erstellt keine Ergebnismenge und verändert ihre Operanden nicht selbst.

Der Empfänger set muss ein echtes Set-Objekt sein; ähnliche Methoden bereitzustellen genügt nicht. Das Argument other darf mengenähnlich sein: Es muss ein gültiges size sowie aufrufbare Methoden has und keys bereitstellen. Ein Set oder Map ist geeignet; bei einer Map werden die Schlüssel geprüft. Iterierbarkeit allein genügt nicht: Ein gewöhnliches Array ist kein gültiges Argument; verwende stattdessen new Set(array).

Bei gewöhnlichen Mengen folgt der Vergleich der Regel SameValueZero: NaN entspricht NaN und +0 entspricht -0; Objekte werden anhand ihrer Identität und nicht ihres Inhalts verglichen. Die Methode vergleicht die interne Elementanzahl von set mit der aus other.size ermittelten Größe; sie liest die öffentliche Eigenschaft set.size nicht. Ist die interne Elementanzahl kleiner oder gleich der Größe von other, durchläuft die Methode set und ruft other.has auf; andernfalls ruft sie Elemente über other.keys ab. Beim ersten gemeinsamen Element wird abgebrochen. Benutzerdefinierte Getter oder Methoden von other können Nebenwirkungen haben oder Ausnahmen auslösen. Vermeide daher, die Mengen während der Prüfung zu verändern.

Die Methode gehört zu ECMAScript 2025, nicht zu den Web APIs. Die Sprachspezifikation bestätigt nicht die Unterstützung in einer bestimmten Browserversion. Prüfe vor der Verwendung in der Zielumgebung typeof Set.prototype.isDisjointFrom === "function"; dass Node 24 in einem Repository vorhanden ist, belegt keine Browserunterstützung.

Beispiele

const selected = new Set([2, 4]);
const available = new Set([1, 3]);
const reserved = new Set([4, 6]);

console.log(selected.isDisjointFrom(available));
console.log(selected.isDisjointFrom(reserved));
console.log(selected.isDisjointFrom(new Set()));

Ergebnis

true
false
true

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