【JavaScript ECMAScript】Set::Set.prototype.addインスタンスメソッドの使い方
Set.prototype.add()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Set.prototype.add()メソッドは、JavaScriptのSetオブジェクトに新しい要素を追加するメソッドです。Setオブジェクトは、重複する値を持たないユニークな値のコレクション(集合)を表す組み込みオブジェクトで、このadd()メソッドはそのSetに値を追加する唯一の方法です。
このメソッドは引数として追加したい任意のJavaScriptの値を受け取ります。指定された値がまだSet内に存在しない場合にのみ、その値がSetに追加されます。もし同じ値が既にSet内に存在していた場合、add()メソッドを実行してもSetの内容は変更されず、既存の値が上書きされることもありません。これはSetが重複を許さないコレクションであるという特性に基づいています。
add()メソッドは要素が追加された(または既に存在していたために変更されなかった)Setオブジェクト自身を戻り値として返します。このため、set.add(value1).add(value2)のように、複数のadd()呼び出しを続けて記述するメソッドチェーンとして使用することも可能です。
この機能は、データの中から重複する要素を取り除き、一意な要素のリストを作成したい場合や、特定の条件を満たすユニークなアイテムだけを管理したい場合など、システム開発の様々な場面で役立ちます。
公式リファレンス: Set.prototype.add()
構文(syntax)
1const mySet = new Set(); 2mySet.add(1); 3mySet.add("example string"); 4mySet.add({ key: "value" });
引数(parameters)
value
- value: any: Set に追加する値
戻り値(return)
Set
Set.prototype.add() メソッドは、指定された要素を Set オブジェクトに追加します。このメソッドは、操作後の Set オブジェクト自体を返します。