Symbol.isConcatSpreadable

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

説明

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

  • 配列オブジェクトにとって、既定の動作は要素の展開(平坦化)です。Symbol.isConcatSpreadable はこれらの場合に平坦化を避けます。
  • 配列状のオブジェクトにとって、既定の動作は展開や平坦化を行いません。Symbol.isConcatSpreadable はこれらの場合に平坦化を強制します。
Symbol.isConcatSpreadable のプロパティ属性
書込可能 不可
列挙可能 不可
設定可能 不可

配列

既定で、Array.prototype.concat() は配列を次の結果のように展開(平坦化)します:

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]

Symbol.isConcatSpreadablefalse に設定した場合、既定の動作を使用できなくなります:

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] ]

配列状のオブジェクト

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

let x = [1, 2, 3]

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

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

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

仕様

仕様書
ECMAScript (ECMA-262)
Symbol.isconcatspreadable の定義

ブラウザー実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
isConcatSpreadableChrome 完全対応 48Edge 完全対応 15Firefox 完全対応 48IE 未対応 なしOpera 完全対応 35Safari 完全対応 10WebView Android 完全対応 48Chrome Android 完全対応 48Firefox Android 完全対応 48Opera Android 完全対応 35Safari iOS 完全対応 10Samsung Internet Android 完全対応 5.0nodejs 完全対応 6.0.0

凡例

完全対応  
完全対応
未対応  
未対応

関連情報