JavaScript

Setオブジェクト

 編集:2022.07.29 by T.A.

やオブジェクト参照を問わず、あらゆる型で一意の値を格納できます。

解説

Set オブジェクトは値のコレクションです。挿入順に要素を反復することができます。Set に重複する値は格納出来ません。Set 内の値はコレクション内で一意となります。

値の等価性

Set オブジェクト内の各値は一意でなければならないので、値の等価性が調べられます。初期の ECMAScript では === 演算子とは違うアルゴリズムが用いられていました。特に +0(厳密に言えば -0 と等価です)と -0 が区別されていた点は重要です。しかしこの振る舞いは ECMAScript 2015 で変更されました。の「-0 と +0 の等価性」を参照してください。

また、NaN と undefined も Set 内に格納できます。NaN は(NaN !== NaN として扱われますが)NaN と同じと扱われます。

コンストラクター
Set()
新しい Set オブジェクトを生成します。
静的プロパティ
get Set[@@species]
派生オブジェクトを生成するために使用されるコンストラクター関数。
インスタンス プロパティ
Set.size
Set オブジェクト内の値の数を返します。
インスタンス メソッド
Set.add(value)
value を Set オブジェクトに追加します。Set オブジェクトを返します。
Set.clear()
すべての要素を Set オブジェクトから取り除きます。
Set.delete(value)
value に関連した要素を取り除き、Set.has(value) が以前に返していたはずの値を返します。Set.has(value) はその後に false を返します。
Set.has(value)
Set オブジェクト内に引数で与えられた値をもつ要素が存在するかどうかを示す真偽値を返します。
反復処理メソッド
Set.prototype[@@iterator]()
挿入順に Set オブジェクト内の各要素に対する values を生み出す新しい Iterator オブジェクトを返します。
Set.keys()
挿入順に Set オブジェクト内の各要素に対する値を含む新しい Iterator オブジェクトを返します。 (Set においては、これはvalues() メソッドと同じです。)
Set.values()
挿入順に Set オブジェクト内の各要素に対する values を含む新しい Iterator オブジェクトを返します。(Set においては、これは keys() メソッドと同じです。)
Set.entries()
挿入順に Set オブジェクト内の各要素に対して [value, value] の配列を含む新しい Iterator オブジェクトを返します。

これは Map オブジェクトに似させています。そのため、Set においては各項目が key と value が同じ値になります。

Set.forEach(callbackFn[, thisArg])
挿入順に Set オブジェクト内に存在する各値に対して一度 callbackFn を呼びます。thisArg 引数が forEach に渡されたら、各コールバックに対して this 値として使用されます。
Set オブジェクトの使用
let mySet = new Set();
mySet.add(1);	// mySet=[1]
mySet.add(5);	// mySet=[1, 5]
mySet.add(5);	// mySet=[1, 5]
mySet.add('some text');	// mySet=[1, 5, 'some text']

let o = {a: 1, b: 2};
mySet.add(o);
mySet.add({a: 1, b: 2});	// o は別のオブジェクトを参照しているので、これは問題ありません

D=mySet.has(1);	//=true
D=mySet.has(3);	//=false。3 は集合にないため
D=mySet.has(5);	//=true
D=mySet.has(Math.sqrt(25));	//=true
D=mySet.has('Some Text'.toLowerCase());	//=true
D=mySet.has(o);	//=true

D=mySet.size;	//=5

mySet.delete(5);	// mySet から 5 を削除
D=mySet.has(5);	//=false。5 が削除されているため

D=mySet.size;	//=4。要素を 1 つ削除しているため

D=mySet;
//¶ logs Set(4) [ 1, "some text", {…}, {…} ] in Firefox
//¶ logs Set(4) { 1, "some text", {…}, {…} } in Chrome
Set の反復操作
//コンソールにて
// iterate over items in set
// logs the items in the order: 1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}
for (let item of mySet) console.log(item)

// logs the items in the order: 1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}
for (let item of mySet.keys()) console.log(item)

// logs the items in the order: 1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}
for (let item of mySet.values()) console.log(item)

// logs the items in the order: 1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}
// (key and value are the same here)
for (let [key, value] of mySet.entries()) console.log(key)

// convert Set object to an Array object, with Array.from
let myArr = Array.from(mySet) // [1, "some text", {"a": 1, "b": 2}, {"a": 1, "b": 2}]

// the following will also work if run in an HTML document
mySet.add(document.body)
mySet.has(document.querySelector('body')) // true

// converting between Set and Array
mySet2 = new Set([1, 2, 3, 4])
mySet2.size                    // 4
[...mySet2]                    // [1, 2, 3, 4]

// intersect can be simulated via
let intersection = new Set([...set1].filter(x => set2.has(x)))

// difference can be simulated via
let difference = new Set([...set1].filter(x => !set2.has(x)))

// Iterate set entries with forEach()
mySet.forEach(function(value) {
  console.log(value)
})

// 1
// 2
// 3
// 4

¶省く

Array オブジェクトとの関係
let myArray = ['value1', 'value2', 'value3'];

// 通常のSetコンストラクターを使用して、配列をSetに変換します
let mySet = new Set(myArray);

D=mySet.has('value1');	//=true

// スプレッド演算子を使用して、セットを配列に変換します。
D=[...mySet];	// myArrayとまったく同じ配列が表示されます
配列から重複した要素を取り除く
// Use to remove duplicate elements from the array
const numbers = [2, 3, 4, 4, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7, 5, 32, 3, 4, 5];

D=[...new Set(numbers)]);	//=[2, 3, 4, 5, 6, 7, 32]
String との関係
let text = 'India';
let mySet = new Set(text);	//=['I', 'n', 'd', 'i', 'a']
D=mySet.size;	//=5

//大文字と小文字の区別と重複の省略
D=new Set("Firefox");	//=["F", "i", "r", "e", "f", "o", "x"]
D=new Set("firefox");	//=["f", "i", "r", "e", "o", "x"]

テスト