Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Set::Set.prototype.unionインスタンスメソッドの使い方

Set.prototype.union()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Set.prototype.union()メソッドは、呼び出し元のSetオブジェクトと別のSetオブジェクトのすべての要素を結合し、重複する要素を取り除いた新しいSetオブジェクトを生成して返すメソッドです。

このメソッドは、集合論における「和集合」の操作に相当します。union()メソッドを呼び出すと、現在のSetオブジェクトのすべての要素と、引数として渡された別のSetオブジェクト(またはSetのように反復可能なオブジェクト)のすべての要素が結合されます。Setオブジェクトは重複する要素を保持しないという特性があるため、結果として得られる新しいSetには、元の両方のSetに含まれていた要素がそれぞれ一意に1つずつだけ含まれます。

例えば、Set Aが{1, 2, 3}で、Set Bが{3, 4, 5}の場合、A.union(B)を実行すると、新しいSetとして{1, 2, 3, 4, 5}が返されます。この処理において、要素「3」はSet AとSet Bの両方に含まれますが、最終的な結果のSetでは1つだけ保持されます。

Set.prototype.union()メソッドは、呼び出し元のSetオブジェクトや引数として渡されたSetオブジェクトの内容を変更することはありません。常に新しいSetオブジェクトを生成して返します。この非破壊的な特性により、元のデータ構造を保護しながら、複数のデータ集合を安全に統合し、重複のない一意なデータセットを効率的に作成したい場合に非常に役立ちます。異なるデータソースから集めた情報を統合する際や、特定の条件に合致する要素の全体像を把握する場面などで利用することができます。

公式リファレンス: Set.prototype.union()

構文(syntax)

1const setA = new Set([1, 2]);
2const setB = new Set([2, 3]);
3const unionSet = setA.union(setB);

引数(parameters)

other

  • other: Set: 合併する他のSetオブジェクト

戻り値(return)

Set

このメソッドは、元のSetと、引数として渡された他のSetのすべての要素を合わせた新しいSetを返します。

関連コンテンツ

関連プログラミング言語