Symbol.isConcatSpreadable
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年4月.
Symbol.isConcatSpreadable は静的データプロパティで、ウェルノウンシンボルである Symbol.isConcatSpreadable を表します。Array.prototype.concat() メソッドは、連結される各オブジェクトに対してこのシンボルを探し、配列風オブジェクトとして扱って配列要素を平坦化すべきかどうかを判断します。
試してみましょう
const alpha = ["a", "b", "c"];
const numeric = [1, 2, 3];
let alphaNumeric = alpha.concat(numeric);
console.log(alphaNumeric);
// Expected output: Array ["a", "b", "c", 1, 2, 3]
numeric[Symbol.isConcatSpreadable] = false;
alphaNumeric = alpha.concat(numeric);
console.log(alphaNumeric);
// Expected output: Array ["a", "b", "c", Array [1, 2, 3]]
値
ウェルノウンシンボル Symbol.isConcatSpreadable です。
Symbol.isConcatSpreadable のプロパティ属性 | |
|---|---|
| 書込可能 | 不可 |
| 列挙可能 | 不可 |
| 設定可能 | 不可 |
解説
[Symbol.isConcatSpreadable] プロパティは、直接または継承されたプロパティとして定義でき、その値は論理値です。これが配列や配列風オブジェクトの挙動を制御できます。
- 配列オブジェクトでは、既定の動作は要素の展開（平坦化）です。
Symbol.isConcatSpreadableにより、これらの場合に平坦化を避けることができます。 - 配列風オブジェクトでは、既定の動作は展開や平坦化を行いません。
Symbol.isConcatSpreadableにより、これらの場合に平坦化を強制することができます。
例
配列
既定で、Array.prototype.concat() は配列を次の結果のように展開（平坦化）します。
const alpha = ["a", "b", "c"];
const numeric = [1, 2, 3];
const alphaNumeric = alpha.concat(numeric);
console.log(alphaNumeric); // 結果: ['a', 'b', 'c', 1, 2, 3]
Symbol.isConcatSpreadable を false に設定すると、既定の動作を無効にすることができます。
const alpha = ["a", "b", "c"];
const numeric = [1, 2, 3];
numeric[Symbol.isConcatSpreadable] = false;
const alphaNumeric = alpha.concat(numeric);
console.log(alphaNumeric); // 結果: ['a', 'b', 'c', [1, 2, 3] ]
配列風オブジェクト
配列風オブジェクトは、既定で展開されません。平坦化された配列を取得するには、Symbol.isConcatSpreadable を true に設定する必要があります。
const x = [1, 2, 3];
const fakeArray = {
[Symbol.isConcatSpreadable]: true,
length: 2,
0: "hello",
1: "world",
};
x.concat(fakeArray); // [1, 2, 3, "hello", "world"]
メモ:
length プロパティは、追加するオブジェクトプロパティの数を制御するために使用されます。上記の例では、length:2 は 2 つのプロパティを追加する必要があることを示しています。
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.isconcatspreadable |
ブラウザーの互換性
Loading…