スプレッド構文とは配列・オブジェクトの展開と残余引数
JavaScriptのスプレッド構文(...)の使い方を、配列の結合、オブジェクトのマージ、関数呼び出し、残余引数の例で解説。浅いコピーの注意点まで実行結果つきで整理します。
この記事の目次
スプレッド構文とは
スプレッド構文(spread syntax)は ... を使って、配列やオブジェクトをその場で展開する構文です。配列の結合、コピー、オブジェクトのマージ、関数の引数展開などに使います。同じ ... でも、関数の引数定義やデストラクチャリングの左辺に書くと「残りをまとめる」残余引数(rest)になり、役割が逆になる点が混乱のもとです。
| 場所 | 名前 | 動作 |
|---|---|---|
| 呼び出し・リテラルの中 | スプレッド | 展開する |
| 引数定義・分割代入の左辺 | 残余(rest) | まとめる |
基本(構文・仕組み)
// 配列リテラルの中で展開
const merged = [...arr1, ...arr2];
// オブジェクトリテラルの中で展開
const obj = { ...base, extra: 1 };
// 関数呼び出しで展開
Math.max(...numbers);
// 残余引数
function sum(...nums) { /* nums は配列 */ }
配列の展開には、イテラブル(配列、文字列、Set、Map など)が使えます。オブジェクトの展開は、自身の列挙可能なプロパティをコピーします。
サンプルコード(実行結果つき)
配列
const a = [1, 2], b = [3, 4];
console.log([...a, ...b, 5]); // [ 1, 2, 3, 4, 5 ]
console.log(Math.max(...[3, 9, 2])); // 9
console.log([...'あい']); // [ 'あ', 'い' ]
console.log([...new Set([1, 1, 2])]); // [ 1, 2 ]
Set に通して展開すると、重複のない配列が作れます。
オブジェクト(後勝ちで上書き)
const o = { x: 1, y: 2 };
console.log({ ...o, y: 20, z: 3 }); // { x: 1, y: 20, z: 3 }
同じキーがあると後ろの値が優先されます。デフォルト設定にユーザー設定を重ねる用途で便利です。
残余引数
function sum(...n) { return n.reduce((s, v) => s + v, 0); }
console.log(sum(1, 2, 3)); // 6
const { x, ...r } = { x: 1, y: 2, z: 3 };
console.log(r); // { y: 2, z: 3 }
配列のコピーと、浅いコピーの注意
const arr = [1, 2, 3];
const arr2 = [...arr];
arr2.push(4);
console.log(arr, arr2); // [ 1, 2, 3 ] [ 1, 2, 3, 4 ]
const nested = { a: { b: 1 } };
const cp = { ...nested };
cp.a.b = 99;
console.log(nested.a.b); // 99
スプレッドは浅いコピーです。ネストしたオブジェクトは参照が共有されるため、元も変わります(詳しくは オブジェクトのコピー)。
エラーになる・意外な結果になる例
console.log({ ...null, ...undefined, ...'hi' }); // { '0': 'h', '1': 'i' }
console.log([...{ a: 1 }]); // TypeError: {(intermediate value)} is not iterable
console.log({ ...[7, 8] }); // { '0': 7, '1': 8 }
null と undefined はオブジェクトの展開では無視されますが、配列の展開ではイテラブルでない値はエラーです。
動作確認(検証環境と結果)
- 環境: Node.js v24.19.0(Windows 11)
- すべて実行して上記コメントの出力と一致することを確認。
- 検証ログ:
C:Tempks2techtestsjs-spread-syntax.md - ブラウザでの実行は未検証。
スプレッド構文の注意点
- スプレッドは浅いコピーです。ネストした値を独立させたい場合は
structuredClone()などを使います。 - 非常に大きな配列を
Math.max(...arr)に渡すと、引数の数の上限でエラーになることがあります。大きな配列はreduceなどで処理してください。 - オブジェクトのスプレッドは、プロトタイプのプロパティや非列挙のプロパティはコピーしません。
スプレッド構文でよくあるミス
- ネストしたオブジェクトまで複製されたと思い込む。
- 順序を間違えて、デフォルト値が上書きされる(
{ ...user, ...defaults }と{ ...defaults, ...user }は結果が逆)。 [...obj]で通常のオブジェクトを展開してエラーになる。- 残余引数を引数の途中に書く(最後にしか書けない)。
ブラウザ対応・バージョン
配列・関数呼び出しのスプレッドは ES2015、オブジェクトのスプレッドは ES2018 で追加されました。現行の主要ブラウザで利用できます。対応バージョンは MDN で最新を確認してください。
スプレッド構文のチェックリスト
- 展開と残余(rest)を取り違えていない
- 上書きの順序(後勝ち)を確認した
- ネストしたデータの共有を意識している
- 展開する値が
null・非イテラブルになる可能性を考えた
スプレッド構文のFAQ(よくある質問)
Q. concat との違いは?
A. 結果は似ていますが、スプレッドは要素を足したり、途中に挿入したりする書き方が自然です。好みの範囲です。
Q. Object.assign と同じですか?
A. 近い動作ですが、Object.assign はターゲットのセッターを呼びます。スプレッドは新しいオブジェクトに定義します。通常の用途ではどちらでも構いません。
Q. 文字列も展開できますか?
A. はい。上の例のように1文字ずつの配列になり、サロゲートペアの文字も1文字として扱われます。
筆者の見解(スプレッド構文)
スプレッド構文は、コピーと結合を直感的に書けるぶん「全部コピーされた」という錯覚を生みやすい点が一番の落とし穴だと考えます。私見では、初心者向けには「一段目だけコピーされる」と図で覚えてもらうのが近道です。深い構造を扱うときは、スプレッドを重ねるより structuredClone を使う方が安全です。
PR SkillHacks
ウェブ制作の次の一歩を、動画講座で自分のペースで進められます
独学のまま詰まって、制作の勉強が止まってしまう前に
こんなお悩みはありませんか?
- HTMLとCSSは分かったが、アプリや仕事の受注までの道筋が見えない
- 独学で詰まったとき、聞ける相手がいない
- スクールは高額で、続けられるか不安
プログラミングの独学は、エラーで進めなくなったときに聞く相手がいないと、そのまま止まりがちです。始める前に、質問できる時間帯と方法、受講期間、料金を確認しておくと選びやすくなります。
Programming Hacks(旧Skill Hacks)は、94本以上の動画で基礎からツール・アプリ作成、仕事の受注まで学べる買い切りのオンライン講座です。目安は1日2時間で2か月。質問は24時間LINEで送れます。
選ばれるポイント
- 仕事の受注まで見通せる。基礎からツール・アプリ作成、仕事の受注までを一つの講座で学べる
- 自分の時間割で進められる。動画講義が94本以上あり、目安は1日2時間で2か月
- 期限を気にせず学べる。受講期間は無制限で、修了後の再受講もでき、会員サイトは永久ログイン
- 詰まっても止まりにくい。24時間LINEで質問でき、サポートは無制限に延長と案内されている
- 追加費用を気にせず続けやすい。買い切り型で、料金は公式サイトに記載。支払いはクレジットカード・PayPal・銀行振込
- 講座の中身を確認してから決められる。運営は株式会社スキルハックス。申込前に特定商取引法の表記と最新の料金を公式サイトで確認する
買い切り型で、受講期間の期限はありません。申込前に講座の内容を公式サイトで確認できます
Programming Hacksの講座ページを開きます
【PR】この枠は広告(アフィリエイト)を含みます。内容は2026年11月15日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
スプレッド構文の関連項目
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
