Set

Set オブジェクトは、プリミティブ値・オブジェクト参照を問わず、あらゆる型で一意の値を格納できます。

このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。

構文

new Set([iterable]);

引数

iterable

反復可能オブジェクトが渡されたら、そのすべての要素が新しい Set オブジェクトに追加されます。それ以外、もしくは null が渡された場合の Set は空で初期化されます。

戻り値

新しい Set オブジェクトです。

説明

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

値の等価性

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

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

プロパティ

Set.length

length の値は 0 です。

Set に含まれる要素の数を知りたい場合は Set.prototype.size を使ってください。

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)

value に関連した要素を取り除き、Set.prototype.has(value) が以前に返していたはずの値を返します。Set.prototype.has(value) はその後に false を返します。

Set.prototype.entries()

挿入順に Set オブジェクト内の各要素に対して [value, value] の配列を含む新しい Iterator オブジェクトを返します。これは Map オブジェクトに似させています。そのため、各エントリーは key と value が同じ値になります。

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

挿入順に Set オブジェクト内に存在する各値に対して一度 callbackFn を呼びます。thisArg 引数が forEach に渡されたら、各コールバックに対して this 値として使用されます。

Set.prototype.has(value)

Set オブジェクト内に引数で与えられた値をもつ要素が存在するかどうかを示す真偽値を返します。

Set.prototype.keys()

values() 関数と同じです。挿入順に Set オブジェクト内の各要素に対する値を含む新しい Iterator オブジェクトを返します。

Set.prototype.values()

挿入順に Set オブジェクト内の各要素に対する values を含む新しい Iterator オブジェクトを返します。

Set.prototype[@@iterator]()

挿入順に Set オブジェクト内の各要素に対する values を含む新しい Iterator オブジェクトを返します。

例

Set オブジェクトの使用

var mySet = new Set();

mySet.add(1); // Set [ 1 ]
mySet.add(5); // Set [ 1, 5 ]
mySet.add(5); // Set [ 1, 5 ]
mySet.add('some text'); // Set [ 1, 5, 'some text' ]
var o = {a: 1, b: 2};
mySet.add(o);

mySet.add({a: 1, b: 2}); // o is referencing a different object so this is okay

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

mySet.size; // 5

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

mySet.size; // 要素を 1 つ削除しているため 4
console.log(mySet);// Set [ 1, "some text", Object {a: 1, b: 2}, Object {a: 1, b: 2} ]

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
var 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 
var intersection = new Set([...set1].filter(x => set2.has(x)));

// difference can be simulated via
var 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

基本的な集合演算を実装する

function isSuperset(set, subset) {
    for (var elem of subset) {
        if (!set.has(elem)) {
            return false;
        }
    }
    return true;
}

function union(setA, setB) {
    var _union = new Set(setA);
    for (var elem of setB) {
        _union.add(elem);
    }
    return _union;
}

function intersection(setA, setB) {
    var _intersection = new Set();
    for (var elem of setB) {
        if (setA.has(elem)) {
            _intersection.add(elem);
        }
    }
    return _intersection;
}

function symmetricDifference(setA, setB) {
    var _difference = new Set(setA);
    for (var elem of setB) {
        if (_difference.has(elem)) {
            _difference.delete(elem);
        } else {
            _difference.add(elem);
        }
    }
  return _difference;
}

function difference(setA, setB) {
    var _difference = new Set(setA);
    for (var elem of setB) {
        _difference.delete(elem);
    }
    return _difference;
}

//Examples
var setA = new Set([1, 2, 3, 4]),
    setB = new Set([2, 3]),
    setC = new Set([3, 4, 5, 6]);

isSuperset(setA, setB); // => true
union(setA, setC); // => Set [1, 2, 3, 4, 5, 6]
intersection(setA, setC); // => Set [3, 4]
symmetricDifference(setA, setC); // => Set [1, 2, 5, 6]
difference(setA, setC); // => Set [1, 2]

Array オブジェクトとの関係

var myArray = ['value1', 'value2', 'value3'];

// Use the regular Set constructor to transform an Array into a Set
var mySet = new Set(myArray);

mySet.has('value1'); // returns true

// Use the spread operator to transform a set into an Array.
console.log([...mySet]); // Will show you exactly the same Array as 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]
 
console.log([...new Set(numbers)]) 

// [2, 3, 4, 5, 6, 7, 32]

String との関係

var text = 'India';

var mySet = new Set(text);  // Set ['I', 'n', 'd', 'i', 'a']
mySet.size;  // 5

仕様書

ブラウザーの対応

関連情報

• Map
• WeakMap
• WeakSet