JavaScriptのコードを読んでいると、配列やオブジェクトの中で …array や …user のようにドットを3つ並べた書き方をよく見かけます。初めて見たときは「これって省略記号なの?それとも何か特別な命令?」と少し戸惑いますよね。
私がJavaScriptのコードを読み始めたころも、… という記号が出てくるたびに「ここはサンプルだから省略されてるのかな?」と勘違いしていた時期がありました。
このドット3つ(…)の正体は、スプレッド構文(Spread Syntax)と呼ばれるJavaScriptの標準機能です。ひとことで言うと、配列やオブジェクトの中身を「パッとその場に展開して広げる」ための記号です。
この記事では、配列とオブジェクトそれぞれのスプレッド構文の基本的な使い方と、使うときに気をつけたい落とし穴、そしてReact開発でよく登場するパターンを紹介します。
スプレッド構文(…)とは?
スプレッド構文は、配列やオブジェクトの前に … を付けることで、中に入っている要素やプロパティをすべて展開してくれる仕組みです(ES2015から配列で使えるようになり、ES2018からオブジェクトでも使えるようになりました)。
イメージとしては、箱(配列やオブジェクト)の中身をテーブルの上にバラバラッと広げるような動きをします。言葉だけだと少し分かりにくいので、配列とオブジェクトそれぞれの実例を見ていきましょう。
配列でのスプレッド構文の使い方
配列では主に「コピー」「結合」「要素の追加」の3つの場面でよく使われます。
1. 配列をコピーする
既存の配列と同じ中身を持つ、新しい配列を作りたいときに使います。
const fruits = ["りんご", "みかん", "バナナ"];
// スプレッド構文で中身を展開し、新しい [] で囲む
const copyFruits = [...fruits];
console.log(copyFruits);
// ["りんご", "みかん", "バナナ"]
ここで大切なのは、単なる const copyFruits = fruits; とは違い、別の新しい配列としてコピーが作られている点です。copyFruits に要素を追加しても、元の fruits には影響しません。
2. 複数の配列を結合する(つなげる)
2つの配列を1つにまとめたいときも、concat メソッドなどを使わずに直感的に書けます。
const morning = ["パン", "コーヒー"];
const lunch = ["カレー", "サラダ"];
const meals = [...morning, ...lunch];
console.log(meals);
// ["パン", "コーヒー", "カレー", "サラダ"]
3. 元の配列を変えずに新しい要素を追加する
元の配列をそのまま残しつつ、末尾や先頭に新しい要素を足した配列を作れます。
const numbers = [1, 2, 3];
// 元の numbers は変えずに、4 を足した新しい配列を作る
const newNumbers = [...numbers, 4];
console.log(numbers);
// [1, 2, 3]
console.log(newNumbers);
// [1, 2, 3, 4]
昔よく使われていた numbers.push(4) は元の配列そのものを書き換えてしまいますが、スプレッド構文なら元のデータを壊さずに新しい配列を作れるのが大きなメリットです。
オブジェクトでのスプレッド構文の使い方
オブジェクトでも、配列とほとんど同じ感覚でコピーやプロパティの追加・上書きができます。
1. オブジェクトのコピーとプロパティの追加
{} の中で …オブジェクト名 と書くと、そのオブジェクトが持つプロパティがすべて展開されます。
const user = {
name: "りあぴ",
age: 17
};
// user の中身を展開しつつ、新しいプロパティを追加
const updatedUser = {
...user,
lang: "JavaScript"
};
console.log(updatedUser);
// { name: "りあぴ", age: 17, lang: "JavaScript" }
2. 一部のプロパティだけを上書きする
展開したあとに同じ名前のプロパティを書くと、後ろに書いた値で上書きされます。
const user = {
name: "りあぴ",
age: 17
};
// age だけを 18 に更新した新しいオブジェクトを作る
const nextYearUser = {
...user,
age: 18
};
console.log(nextYearUser);
// { name: "りあぴ", age: 18 }
反対に、{ age: 18, …user } のように …user を後ろに書いてしまうと、元の age: 17 で上書きされてしまうので順番には注意してください。
注意点:浅いコピー(シャローコピー)になる
スプレッド構文はとても便利ですが、1つだけハマりやすいポイントがあります。それは、コピーされるのは一番上の階層だけ(浅いコピー=シャローコピー)という点です。
オブジェクトの中にさらにオブジェクト(ネストされたデータ)が入っている場合、内側のオブジェクトはコピーされず、元のデータと共有されたままになります。
const user = {
name: "りあぴ",
sns: {
x: "@riapi_js"
}
};
const copyUser = { ...user };
// 内側のプロパティを書き換えると…
copyUser.sns.x = "@changed_id";
// 元の user の中身まで変わってしまう!
console.log(user.sns.x);
// "@changed_id"
ネストされた中身まで安全にコピーしたい場合は、内側の階層もスプレッド構文で展開し直すか、モダンブラウザで使える structuredClone(user) を使います。最初は「深い階層があるときは気をつける」くらいに覚えておけば十分です。
React開発でスプレッド構文がよく登場する場面
Reactを書いていると、スプレッド構文は毎日のように使います。特に出番が多いのがuseState で配列やオブジェクトを更新するときです。
Reactには「State(状態)の中身を直接書き換えず、必ず新しい配列やオブジェクトを作って渡す(イミュータブルに扱う)」というルールがあります。そのため、配列に要素を足すときやオブジェクトの一部を変えるときにスプレッド構文が定番の書き方になります。
import { useState } from "react";
function TodoList() {
const [todos, setTodos] = useState(["環境構築", "JSの復習"]);
const addTodo = () => {
// todos.push("React入門") のように直接書き換えるのはNG
// スプレッド構文で新しい配列を作って渡す
setTodos([...todos, "React入門"]);
};
return (
<div>
<button onClick={addTodo}>タスクを追加</button>
<ul>
{todos.map((todo, index) => (
<li key={index}>{todo}</li>
))}
</ul>
</div>
);
}
このほか、コンポーネントに複数の props をまとめて渡すとき(<UserCard {…user}/>)にも使われます。以前の記事で紹介した分割代入(Destructuring)とセットで覚えておくと、Reactのコードがぐっと読みやすくなります。
まとめ
スプレッド構文(…)は、配列やオブジェクトの中身を展開して、元のデータを壊さずにコピー・結合・更新を行うための書き方です。
- 配列のコピー・追加: const newArr = […arr, “新しい要素”];
- オブジェクトのコピー・更新: const newObj = { …obj, key: “新しい値” };
- 注意点: 深い階層(ネスト)まではコピーされない(浅いコピーになる)
最初はドット3つの見た目に慣れないかもしれませんが、自分で配列やオブジェクトを少し動かしてみるとすぐに感覚がつかめます。まずはシンプルな配列の結合やコピーから試してみてください。


コメント