WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.isSubsetOf — Teilmengen prüfen

Set.prototype.isSubsetOf prüft, ob jedes Element einer Menge in einer anderen Menge oder einem mengenähnlichen Objekt vorkommt. Die Methode gibt einen Boolean zurück; auch gleiche Mengen erfüllen diese Bedingung.

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

set.isSubsetOf(other) gibt true zurück, wenn jedes Element von set zu other gehört, andernfalls false. Die Methode prüft keine echte Teilmenge: Eine Menge ist eine Teilmenge ihrer selbst. Die leere Menge ist eine Teilmenge jeder gültigen Menge. Die Methode selbst verändert die Mengen nicht.

Der Empfänger set muss ein tatsächliches Set-Objekt sein. Das Argument other kann ein Set oder ein Objekt mit einer size-Eigenschaft sowie aufrufbaren Methoden has und keys sein, zum Beispiel eine Map, deren Schlüssel geprüft werden. Iterierbarkeit allein reicht nicht aus: Ein Array ist kein gültiges Argument. Die Methode verlangt eine aufrufbare keys-Methode, obwohl sie diese nicht aufruft.

Nach der Validierung des Arguments gibt die Methode false zurück, wenn die Anzahl der intern in set gespeicherten Elemente größer ist als die Größe von other. Bei diesem Vergleich liest die Methode die Eigenschaft set.size nicht aus. Andernfalls prüft sie die Elemente über other.has und beendet die Prüfung beim ersten fehlenden Element. Bei gewöhnlichen Mengen werden Objekte anhand ihrer Identität und nicht anhand ihres Inhalts verglichen. Eigene Getter und Methoden des Arguments können Nebenwirkungen haben oder Ausnahmen auslösen.

Die Methode gehört zu ECMAScript 2025, nicht zu den Web APIs. Die Spezifikation bestätigt nicht die Unterstützung in einem bestimmten Browser; auch Node 24 in einem Repository beweist sie nicht. Prüfe typeof Set.prototype.isSubsetOf === "function" in der Zielumgebung.

Beispiele

const required = new Set(["read"]);
const granted = new Set(["read", "write"]);

console.log(required.isSubsetOf(granted));
console.log(granted.isSubsetOf(required));
console.log(required.isSubsetOf(required));
console.log(new Set().isSubsetOf(granted));

Ergebnis

true
false
true
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