WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Set.prototype.isSupersetOf — auf Obermengen prüfen

Die Methode isSupersetOf() prüft, ob ein Set jedes Element einer anderen set-ähnlichen Sammlung enthält. Sie gibt einen booleschen Wert zurück; auch gleiche Sets erfüllen die Bedingung. Es handelt sich daher nicht um einen Test auf echte Obermengen.

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

set.isSupersetOf(other) gibt true zurück, wenn set jedes Element von other enthält, andernfalls false. Auch gleiche Sets erfüllen die Bedingung, und jedes Set ist eine Obermenge eines leeren Set. Die Methode selbst verändert die Sets nicht.

Der Empfänger set muss ein tatsächliches Set-Objekt sein; ähnliche Methoden bereitzustellen reicht nicht aus. Das Argument other kann ein set-ähnliches Objekt sein: Es besitzt eine Eigenschaft size sowie aufrufbare Methoden has() und keys(). Die Methode wandelt size in eine Zahl um, weist NaN zurück, schneidet bei endlichen Werten die Nachkommastellen ab (Rundung in Richtung null) und weist anschließend ein negatives Ergebnis zurück. Beispielsweise wird die Zeichenfolge "1" als Größe 1 akzeptiert. Sowohl Set als auch Map erfüllen diese Anforderungen — bei einer Map werden ihre Schlüssel verwendet. Ein gewöhnliches Array erfüllt diesen Vertrag nicht; verwende new Set(array).

Nach der Validierung des Arguments gibt die Methode false zurück, wenn die Größe des Empfängers kleiner als die Größe von other ist. Andernfalls durchläuft sie other.keys() und hält beim ersten fehlenden Element an. other.has() muss vorhanden sein, wird von diesem Algorithmus aber nicht aufgerufen. Die Zugehörigkeitsprüfung folgt der SameValueZero-Semantik: NaN entspricht NaN, +0 und -0 gelten als gleich, und Objekte werden anhand ihrer Identität verglichen. Eigene Getter und Iteratoren können Code mit Nebenwirkungen ausführen.

Die Methode ist Bestandteil von ECMAScript 2025. Aus der Sprachspezifikation lässt sich keine Unterstützung in einem bestimmten Browser ableiten; prüfe vor der Verwendung in der Zielumgebung typeof Set.prototype.isSupersetOf === 'function'. Die in einem Repository verwendete Node-Version belegt keine Browser-Unterstützung.

Beispiele

const available = new Set(['read', 'write', 'share']);
const required = new Set(['read', 'write']);

console.log(available.isSupersetOf(required));
console.log(required.isSupersetOf(available));
console.log(available.isSupersetOf(available));
console.log(available.isSupersetOf(new Set()));

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