Set.prototype.isSubsetOf()

Syntax

isSubsetOf(other)

Parameter

other

Ein Set-Objekt oder ein set-ähnliches Objekt.

Rückgabewert

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

Beschreibung

In mathematischer Notation ist Teilmenge definiert als:

Und mit Hilfe eines Venn-Diagramms:

isSubsetOf() akzeptiert set-ähnliche Objekte als other-Parameter. Es erfordert, dass this eine echte Set-Instanz ist, da es direkt auf die zugrunde liegenden Daten in this zugreift, ohne benutzerdefinierten Code aufzurufen. Dann hängt das Verhalten von den Größen von this und other ab:

• Wenn mehr Elemente in this sind als other.size, wird direkt false zurückgegeben.
• Ansonsten wird über die Elemente in this iteriert, und false wird zurückgegeben, wenn ein Element e in this dazu führt, dass other.has(e) einen falsy Wert zurückgibt. Andernfalls wird true zurückgegeben.

Beispiele

Verwendung von isSubsetOf()

Die Menge der Vielfachen von 4 (<20) ist eine Teilmenge der geraden Zahlen (<20):

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

Die Menge der Primzahlen (<20) ist keine Teilmenge aller ungeraden Zahlen (<20), da 2 eine Primzahl ist, aber nicht ungerade:

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(primes.isSubsetOf(odds)); // false

Gleiche Mengen sind Teilmengen voneinander:

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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