Set.prototype.isSupersetOf()

other

Ein Set Objekt oder ein mengenähnliches Objekt.

true, wenn alle Elemente in der other Menge auch in dieser Menge sind, andernfalls false.

In mathematischer Notation ist Obermenge definiert als:

Und mit einem Venn-Diagramm dargestellt:

isSupersetOf() akzeptiert mengenähnliche Objekte als den other Parameter. Es erfordert, dass this eine tatsächliche Set Instanz ist, weil es direkt die zugrunde liegenden Daten in this abruft, ohne Benutzer-Code aufzurufen. Dann hängt sein Verhalten von der Größe von this und other ab:

• Wenn es in this weniger Elemente gibt als other.size, dann gibt es direkt false zurück.
• Andernfalls iteriert es über other, indem es dessen keys() Methode aufruft und wenn ein beliebiges Element in other nicht in this vorhanden ist, gibt es false zurück (und schließt den keys() Iterator, indem es dessen return() Methode aufruft). Andernfalls gibt es true zurück.

Die Menge der geraden Zahlen (<20) ist eine Obermenge 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 keine Obermenge 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 Obermengen 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

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