path: root/files/ja/web/javascript/reference/global_objects/set/index.html

---
title: Set
slug: Web/JavaScript/Reference/Global_Objects/Set
tags:
  - Class
  - ECMAScript 2015
  - Global Objects
  - JavaScript
  - Object
  - Reference
  - set
translation_of: Web/JavaScript/Reference/Global_Objects/Set
---
<div>{{JSRef}}</div>

<p><span class="seoSummary"><strong><code>Set</code></strong> オブジェクトは、{{Glossary("Primitive", "プリミティブ値")}}やオブジェクト参照を問わず、あらゆる型で一意の値を格納できます。</span></p>

<h2 id="Description" name="Description">解説</h2>

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

<h3 id="Value_equality" name="Value_equality">値の等価性</h3>

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

<p>また、 {{jsxref("NaN")}} と {{jsxref("undefined")}} も Set 内に格納できます。<code>NaN</code> は (<code>NaN !== NaN</code> として扱われますが) <code>NaN</code> と同じと扱われます。</p>

<h2 id="Constructor" name="Constructor">コンストラクター</h2>

<dl>
 <dt>{{jsxref("Global_Objects/Set/Set", "Set()")}}</dt>
 <dd>新しい <code>Set</code> オブジェクトを生成します。</dd>
</dl>

<h2 id="Static_properties" name="Static_properties">静的プロパティ</h2>

<dl>
 <dt>{{jsxref("Set.@@species", "get Set[@@species]")}}</dt>
 <dd>派生オブジェクトを生成するために使用されるコンストラクター関数。</dd>
</dl>

<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2>

<dl>
 <dt>{{jsxref("Set.prototype.size")}}</dt>
 <dd><code>Set</code> オブジェクト内の値の数を返します。</dd>
</dl>

<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2>

<dl>
 <dt>{{jsxref("Set.add", "Set.prototype.add(<var>value</var>)")}}</dt>
 <dd><code><var>value</var></code> を <code>Set</code> オブジェクトに追加します。<code>Set</code> オブジェクトを返します。</dd>
 <dt>{{jsxref("Set.prototype.clear()")}}</dt>
 <dd>すべての要素を <code>Set</code> オブジェクトから取り除きます。</dd>
 <dt>{{jsxref("Set.delete", "Set.prototype.delete(<var>value</var>)")}}</dt>
 <dd><code><var>value</var></code> に関連した要素を取り除き、<code>Set.prototype.has(<var>value</var>)</code> が以前に返していたはずの値を返します。<code>Set.prototype.has(<var>value</var>)</code> はその後に <code>false</code> を返します。</dd>
 <dt>{{jsxref("Set.has", "Set.prototype.has(<var>value</var>)")}}</dt>
 <dd><code>Set</code> オブジェクト内に引数で与えられた値をもつ要素が存在するかどうかを示す真偽値を返します。</dd>
</dl>

<h3 id="Iteration_methods" name="Iteration_methods">反復処理メソッド</h3>

<dl>
 <dt>{{jsxref("Set.prototype.@@iterator()", "Set.prototype[@@iterator]()")}}</dt>
 <dd>挿入順に <code>Set</code> オブジェクト内の各要素に対する <strong>values</strong> を生み出す新しい <code>Iterator</code> オブジェクトを返します。</dd>
 <dt>{{jsxref("Set.prototype.keys()")}}</dt>
 <dd>挿入順に <code>Set</code> オブジェクト内の各要素に対する値を含む新しい <code>Iterator</code> オブジェクトを返します。 (Set においては、これは<strong><code>values()</code></strong> メソッドと同じです。)</dd>
 <dt>{{jsxref("Set.prototype.values()")}}</dt>
 <dd>挿入順に <code>Set</code> オブジェクト内の各要素に対する <strong>values</strong> を含む新しい <code>Iterator</code> オブジェクトを返します。 (Set においては、これは <strong><code>keys()</code></strong> メソッドと同じです。</dd>
 <dt>{{jsxref("Set.prototype.entries()")}}</dt>
 <dd>
 <p>挿入順に <code>Set</code> オブジェクト内の各要素に対して <strong><code>[<var>value</var>, <var>value</var>]</code> の配列</strong>を含む新しい <code>Iterator</code> オブジェクトを返します。</p>

 <p>これは {{jsxref("Map")}} オブジェクトに似させています。そのため、 <code>Set</code> においては各項目が <em>key</em> と <em>value</em> が同じ値になります。</p>
 </dd>
 <dt>{{jsxref("Set.forEach", "Set.prototype.forEach(<var>callbackFn</var>[, <var>thisArg</var>])")}}</dt>
 <dd>挿入順に <code>Set</code> オブジェクト内に存在する各値に対して一度 <code>callbackFn</code> を呼びます。<code>thisArg</code> 引数が <code>forEach</code> に渡されたら、各コールバックに対して <code>this</code> 値として使用されます。</dd>
</dl>

<h2 id="Examples" name="Examples">例</h2>

<h3 id="Using_the_Set_object" name="Using_the_Set_object">Set オブジェクトの使用</h3>

<pre class="brush: js notranslate">let 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' ]
let 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)    // Set から 5 を削除
mySet.has(5)       // 5 が削除されているため false

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

console.log(mySet)
// logs Set(4) [ 1, "some text", {…}, {…} ] in Firefox
// logs Set(4) { 1, "some text", {…}, {…} } in Chrome
</pre>

<h3 id="Iterating_Sets" name="Iterating_Sets">Set の反復操作</h3>

<pre class="brush: js notranslate">// 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 <a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Array/from">Array.from</a>
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 =&gt; set2.has(x)))

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

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

// 1
// 2
// 3
// 4</pre>

<h3 id="Implementing_basic_set_operations" name="Implementing_basic_set_operations">基本的な集合演算の実装</h3>

<pre class="brush: js notranslate">function isSuperset(set, subset) {
    for (let elem of subset) {
        if (!set.has(elem)) {
            return false
        }
    }
    return true
}

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

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

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

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

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

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

</pre>

<h3 id="Relation_with_Array_objects" name="Relation_with_Array_objects">Array オブジェクトとの関係</h3>

<pre class="brush: js notranslate">let myArray = ['value1', 'value2', 'value3']

// Use the regular Set constructor to transform an Array into a Set
let 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
</pre>

<h3 id="Remove_duplicate_elements_from_the_array" name="Remove_duplicate_elements_from_the_array">配列から重複した要素を取り除く</h3>

<pre class="brush: js notranslate">// 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]</pre>

<h3 id="Relation_with_Strings" name="Relation_with_Strings">String との関係</h3>

<pre class="brush: js notranslate">let text = 'India'

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

//case sensitive &amp; duplicate ommision
new Set("Firefox")  // Set(7) [ "F", "i", "r", "e", "f", "o", "x" ]
new Set("firefox")  // Set(6) [ "f", "i", "r", "e", "o", "x" ]
</pre>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-set-objects', 'Set')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>

<p>{{Compat("javascript.builtins.Set")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{jsxref("Map")}}</li>
 <li>{{jsxref("WeakMap")}}</li>
 <li>{{jsxref("WeakSet")}}</li>
</ul>