Set.prototype.isSupersetOf()

Syntax

isSupersetOf(other)

Parameter

other

Ein Set Objekt oder ein set-hnliches Objekt.

Rckgabewert

true, wenn alle Elemente im other Set auch in diesem Set sind, andernfalls false.

Beschreibung

In mathematischer Notation ist ein Superset definiert als:

Und in einem Venn-Diagramm:

[Ein Venn-Diagramm mit zwei Kreisen. A ist ein Superset von B, weil B vollstndig in A enthalten ist.]

isSupersetOf() akzeptiert set-hnliche Objekte als other Parameter. Es erfordert, dass this eine tatschliche Set Instanz ist, da es die darunter liegenden Daten direkt extrahiert, die in this gespeichert sind, ohne jeglichen Benutzercode aufzurufen. Dann hngt das Verhalten von den Gren von this und other ab:

• Wenn es weniger Elemente in this als other.size gibt, wird direkt false zurckgegeben.
• Andernfalls iteriert es ber other und ruft dessen keys() Methode auf. Wenn ein Element in other nicht in this vorhanden ist, gibt es false zurck (und schliet den keys() Iterator, indem es dessen return() Methode aufruft). Andernfalls gibt es true zurck.

Beispiele

Verwendung von isSupersetOf()

Die Menge der geraden Zahlen (<20) ist ein Superset der Vielfachen von 4 (<20):

const evens = new Set([2, 4, 6, 8, 10, 12, 14, 16, 18]);
const fours = new Set([4, 8, 12, 16]);
console.log(evens.isSupersetOf(fours)); // true

Die Menge aller ungeraden Zahlen (<20) ist kein Superset der Primzahlen (<20), weil 2 eine Primzahl, aber nicht ungerade ist:

const primes = new Set([2, 3, 5, 7, 11, 13, 17, 19]);
const odds = new Set([3, 5, 7, 9, 11, 13, 15, 17, 19]);
console.log(odds.isSupersetOf(primes)); // false

quivalente Mengen sind Supersets voneinander:

const set1 = new Set([1, 2, 3]);
const set2 = new Set([1, 2, 3]);
console.log(set1.isSupersetOf(set2)); // true
console.log(set2.isSupersetOf(set1)); // true

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Set.prototype.isSupersetOf in core-js
• es-shims Polyfill von Set.prototype.isSupersetOf
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.symmetricDifference()
• Set.prototype.union()