---
title: Symbol.isConcatSpreadable
slug: Web/JavaScript/Reference/Global_Objects/Symbol/isConcatSpreadable
tags:
  - ECMAScript 2015
  - JavaScript
  - Property
  - Symbol
translation_of: Web/JavaScript/Reference/Global_Objects/Symbol/isConcatSpreadable
---
<div>{{JSRef}}</div>

<p><strong><code>Symbol.isConcatSpreadable</code></strong> は、{{jsxref("Array.prototype.concat()")}} メソッドを使用してオブジェクトを配列の要素に平坦化する場合の設定として使用されます。</p>

<div>{{EmbedInteractiveExample("pages/js/symbol-isconcatspreadable.html")}}</div>



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

<p><code>@@isConcatSpreadable</code> シンボル（<code>Symbol.isConcatSpreadable</code>）は直接、または継承されたプロパティとして定義でき、その値は boolean です。これは、配列や配列状のオブジェクトの振る舞いを制御します：</p>

<ul>
 <li>配列オブジェクトにとって、既定の動作は要素の展開（平坦化）です。<code>Symbol.isConcatSpreadable</code> はこれらの場合に平坦化を避けます。</li>
 <li>配列状のオブジェクトにとって、既定の動作は展開や平坦化を行いません。<code>Symbol.isConcatSpreadable</code> はこれらの場合に平坦化を強制します。</li>
</ul>

<p>{{js_property_attributes(0,0,0)}}</p>

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

<h3 id="Arrays" name="Arrays">配列</h3>

<p>既定で、{{jsxref("Array.prototype.concat()")}} は配列を次の結果のように展開（平坦化）します：</p>

<pre class="brush: js notranslate">let alpha = ['a', 'b', 'c'],
let numeric = [1, 2, 3]

let alphaNumeric = alpha.concat(numeric)

console.log(alphaNumeric)  // Result: ['a', 'b', 'c', 1, 2, 3]
</pre>

<p><code>Symbol.isConcatSpreadable</code> を <code>false</code> に設定した場合、既定の動作を使用できなくなります：</p>

<pre class="brush: js notranslate">let alpha = ['a', 'b', 'c'],
let numeric = [1, 2, 3]

numeric[Symbol.isConcatSpreadable] = false
let alphaNumeric = alpha.concat(numeric)

console.log(alphaNumeric)  // Result: ['a', 'b', 'c', [1, 2, 3] ]
</pre>

<h3 id="Array-like_objects" name="Array-like_objects">配列状のオブジェクト</h3>

<p>配列状のオブジェクトは、既定で展開しません。<code>Symbol.isConcatSpreadable</code> 平坦化した配列を取得するには、<code>true</code> に設定する必要があります：</p>

<pre class="brush: js notranslate">let x = [1, 2, 3]

let fakeArray = {
  [Symbol.isConcatSpreadable]: true,
  length: 2,
  0: 'hello',
  1: 'world'
}

x.concat(fakeArray)  // [1, 2, 3, "hello", "world"]
</pre>

<div class="blockIndicator note">
<p><strong>注:</strong> <code>length</code> プロパティは、追加するオブジェクトプロパティの数を制御するために使用されます。上記の例では、<code>length:2</code> は 2 つのプロパティを追加する必要があることを示しています。</p>
</div>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様書</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-symbol.isconcatspreadable', 'Symbol.isconcatspreadable')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>



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

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

<ul>
 <li>{{jsxref("Array.prototype.concat()")}}</li>
</ul>