Set.prototype.difference()

語法

difference(other)

引數

其他

一個 Set 物件，或 類 Set 物件。

返回值

一個包含當前集合中存在但不在 other 集合中的元素的新 Set 物件。

描述

在數學表示法中，差集 定義為

使用維恩圖表示：

difference() 方法接受 類集合（set-like） 物件作為 other 引數。它要求 this 是一個實際的 Set 例項，因為它直接檢索 this 中儲存的底層資料，而不呼叫任何使用者程式碼。然後，其行為取決於 this 和 other 的大小。

• 如果 this 中的元素多於 other.size，則它透過呼叫 keys() 方法迭代 other，並使用 this 中所有未在 other 中出現的元素構造一個新集合。
• 否則，它會迭代 this 中的元素，並使用 this 中所有導致 other.has(e) 返回 假值（falsy） 的元素 e 來構造一個新集合。

返回集合中元素的順序與 this 中一致。

示例

使用 difference()

以下示例計算小於 10 的奇數集合與小於 10 的完全平方數集合的差集。結果是那些不是完全平方數的奇數集合。

const odds = new Set([1, 3, 5, 7, 9]);
const squares = new Set([1, 4, 9]);
console.log(odds.difference(squares)); // Set(3) { 3, 5, 7 }

規範

瀏覽器相容性

另見

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