Set.prototype.isSupersetOf()

Baseline 2024
新推出

自 2024 年 6 月起,此功能已在最新的设备和浏览器版本中可用。此功能可能不适用于较旧的设备或浏览器。

isSupersetOf() 方法用于判断一个 Set 实例是否包含另一个 set 中的所有元素,并返回一个布尔值。

语法

js
isSupersetOf(other)

参数

其他

一个 Set 对象,或 类 Set 对象

返回值

如果 other set 中的所有元素也都存在于此 set 中,则返回 true,否则返回 false

描述

在数学表示法中,超集 定义为

ABxB,xAA\supseteq B \Leftrightarrow \forall x\in B,\,x\in A

使用维恩图表示:

A Venn diagram with two circles. A is a superset of B because B is completely contained in A.

注意: 超集 关系不等于真超集,这意味着如果 thisother 包含相同的元素,isSupersetOf() 也会返回 true

isSupersetOf() 接受 类 Set 对象作为 other 参数。它要求 this 是一个实际的 Set 实例,因为它直接检索 this 中存储的底层数据,而无需调用任何用户代码。然后,其行为取决于 thisother 的大小。

  • 如果 this 中的元素数量少于 other.size,则直接返回 false
  • 否则,它会通过调用 otherkeys() 方法来迭代 other,如果 other 中的任何元素不在 this 中,则返回 false(并通过调用其 return() 方法关闭 keys() 迭代器)。否则,返回 true

示例

使用 isSupersetOf()

偶数集合(<20)是 4 的倍数集合(<20)的超集

js
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

所有奇数集合(<20)不是素数集合(<20)的超集,因为 2 是素数但不是奇数

js
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

相等的集合互为超集

js
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

规范

规范
ECMAScript® 2026 语言规范
# sec-set.prototype.issupersetof

浏览器兼容性

另见