Set 對象允許你存儲任何類型的唯一值，無論是原始值或者是對象引用。

 1 const set1 = new Set([1, 2, 3, 4, 5]);
 2 
 3 console.log(set1.has(1));
 4 // expected output: true
 5 
 6 console.log(set1.has(5));
 7 // expected output: true
 8 
 9 console.log(set1.has(6));
10 // expected output: false

語法

new Set([iterable]);

參數

iterable

如果傳遞一個可叠代對象，它的所有元素將被添加到新的 Set中。如果不指定此參數或其值為null，則新的 Set為空。

返回值

一個新的Set對象。

簡述

Set對象是值的集合，你可以按照插入的順序叠代它的元素。 Set中的元素只會出現一次，即 Set 中的元素是唯一的。

值的相等

因為 Set 中的值總是唯一的，所以需要判斷兩個值是否相等。在ECMAScript規範的早期版本中，這不是基於和===操作符中使用的算法相同的算法。具體來說，對於 Set s， +0 （+0 嚴格相等於-0）和-0是不同的值。然而，在 ECMAScript 2015規範中這點已被更改。有關詳細信息，請參閱瀏覽器兼容性 表中的“value equality for -0 and 0”。

另外，NaN和undefined都可以被存儲在Set 中， NaN之間被視為相同的值（盡管 NaN !== NaN）。

屬性

Set.length

length屬性的值為0。

get Set[@@species]

構造函數用來創建派生對象.

Set.prototype

表示Set構造器的原型，允許向所有Set對象添加新的屬性。

Set實例

所有Set實例繼承自 Set.prototype。

屬性

Set.prototype.constructor

返回實例的構造函數。默認情況下是Set。

Set.prototype.size

返回Set對象的值的個數。

方法

Set.prototype.add(value)

在Set對象尾部添加一個元素。返回該Set對象。

Set.prototype.clear()

移除Set對象內的所有元素。

Set.prototype.delete(value)

移除Set的中與這個值相等的元素，返回Set.prototype.has(value)在這個操作前會返回的值（即如果該元素存在，返回true，否則返回false）。Set.prototype.has(value)在此後會返回false。

Set.prototype.entries()

返回一個新的叠代器對象，該對象包含Set對象中的按插入順序排列的所有元素的值的[value, value]數組。為了使這個方法和Map對象保持相似， 每個值的鍵和值相等。

Set.prototype.forEach(callbackFn[, thisArg])

按照插入順序，為Set對象中的每一個值調用一次callBackFn。如果提供了thisArg參數，回調中的this會是這個參數。

Set.prototype.has(value)

返回一個布爾值，表示該值在Set中存在與否。

Set.prototype.keys()

與values()方法相同，返回一個新的叠代器對象，該對象包含Set對象中的按插入順序排列的所有元素的值。

Set.prototype.values()

返回一個新的叠代器對象，該對象包含Set對象中的按插入順序排列的所有元素的值。

Set.prototype[@@iterator]()

返回一個新的叠代器對象，該對象包含Set對象中的按插入順序排列的所有元素的值。

示例

使用Set對象

 1 let mySet = new Set();
 2 
 3 mySet.add(1); // Set(1) {1}
 4 mySet.add(5); // Set(2) {1, 5}
 5 mySet.add(5); // Set { 1, 5 }
 6 mySet.add("some text"); // Set(3) {1, 5, "some text"}
 7 var o = {a: 1, b: 2};
 8 mySet.add(o);
 9 
10 mySet.add({a: 1, b: 2}); // o 指向的是不同的對象，所以沒問題
11 
12 mySet.has(1); // true
13 mySet.has(3); // false
14 mySet.has(5);              // true
15 mySet.has(Math.sqrt(25));  // true
16 mySet.has("Some Text".toLowerCase()); // true
17 mySet.has(o); // true
18 
19 mySet.size; // 5
20 
21 mySet.delete(5);  // true,  從set中移除5
22 mySet.has(5);     // false, 5已經被移除
23 
24 mySet.size; // 4, 剛剛移除一個值
25 console.log(mySet); // Set {1, "some text", Object {a: 1, b: 2}, Object {a: 1, b: 2}}

叠代Set

 1 // 叠代整個set
 2 // 按順序輸出：1, "some text" 
 3 for (let item of mySet) console.log(item);
 4 
 5 // 按順序輸出：1, "some text" 
 6 for (let item of mySet.keys()) console.log(item);
 7  
 8 // 按順序輸出：1, "some text" 
 9 for (let item of mySet.values()) console.log(item);
10 
11 // 按順序輸出：1, "some text" 
12 //(鍵與值相等)
13 for (let [key, value] of mySet.entries()) console.log(key);
14 
15 // 轉換Set為Array (with Array comprehensions)
16 var myArr = [v for (v of mySet)]; // [1, "some text"]
17 // 替代方案(with Array.from)
18 var myArr = Array.from(mySet); // [1, "some text"]
19 
20 // 如果在HTML文檔中工作，也可以：
21 mySet.add(document.body);
22 mySet.has(document.querySelector("body")); // true
23 
24 // Set 和 Array互換
25 mySet2 = new Set([1,2,3,4]);
26 mySet2.size; // 4
27 [...mySet2]; // [1,2,3,4]
28 
29 // intersect can be simulated via 
30 var intersection = new Set([...set1].filter(x => set2.has(x)));
31 
32 // difference can be simulated via
33 var difference = new Set([...set1].filter(x => !set2.has(x)));
34 
35 // 用forEach叠代
36 mySet.forEach(function(value) {
37   console.log(value);
38 });
39 
40 // 1
41 // 2
42 // 3
43 // 4

Array 相關

1 var myArray = ["value1", "value2", "value3"];
2 
3 // 用Set構造器將Array轉換為Set
4 var mySet = new Set(myArray);
5 
6 mySet.has("value1"); // returns true
7 
8 // 用...(展開操作符)操作符將Set轉換為Array
9 console.log([...mySet]); // 與myArray完全一致

String 相關

1 var text = ‘Indiana‘;
2 
3 var mySet = new Set(text);  // Set {‘I‘, ‘n‘, ‘d‘, ‘i‘, ‘a‘}
4 mySet.size;  // 5

JavaScript --- ES6 Set 集合結構詳解