Set.prototype.union()

構文

union(other)

引数

other

Set オブジェクト、または Set 風オブジェクトです。

返値

新しい Set オブジェクトで、この Set と other の集合のどちらかまたは両方にある要素が入ったものです。

解説

数学的な記法では、和集合 (union) は次のように定義されます。

ベン図を使うとこうなります。

union() は、Set 風オブジェクトを other 引数として受け入れます。this は、ユーザーコードを呼び出すことなく、this オブジェクトに格納されているデータに直接アクセスするため、実際の Set インスタンスであることが要求されます。次に、other の keys() メソッドを呼び出して繰り返し処理を行い、this に存在するすべての要素、次に other に存在して this に存在しないすべての要素をすべて含む新しい Set を構築します。

返される Set 内の要素の順序は、まず this の要素、次に other の要素となります。

例

union() の使用

次の例では、偶数（10 未満）と完全平方（10 未満）の和集合を計算します。結果は、完全平方または偶数のどちら、または両方にある数の集合となります。

const evens = new Set([2, 4, 6, 8]);
const squares = new Set([1, 4, 9]);
console.log(evens.union(squares)); // Set(6) { 2, 4, 6, 8, 1, 9 }

仕様書

ブラウザーの互換性

関連情報

• Set.prototype.union のポリフィル (core-js)
• es-shims による Set.prototype.union のポリフィル
• Set.prototype.difference()
• Set.prototype.intersection()
• Set.prototype.isDisjointFrom()
• Set.prototype.isSubsetOf()
• Set.prototype.isSupersetOf()
• Set.prototype.symmetricDifference()