分割代入とは配列・オブジェクトの書き方と落とし穴
JavaScriptの分割代入(destructuring)を、配列・オブジェクト・関数引数の例で解説。デフォルト値、別名、入れ替え、nullで起きるエラーまで実行結果つきで整理します。
この記事の目次
分割代入とは
分割代入(destructuring assignment)は、配列やオブジェクトから値を取り出して、複数の変数へ一度に代入する構文です。ES2015で追加されました。APIのレスポンスや関数の引数を扱うときに、user.name、user.id と何度も書く手間を減らせます。
基本(構文・仕組み)
オブジェクトの分割代入
const user = { id: 1, name: 'Taro', addr: { city: 'Tokyo' } };
const { id, name } = user;
変数名はプロパティ名と一致させます。別名にしたいときは プロパティ名: 変数名、デフォルト値は = 値 です。
配列の分割代入
const [a, b] = [10, 20];
配列は順番で取り出します。不要な要素は空けて [a, , c] のようにスキップできます。
| 目的 | 書き方 |
|---|---|
| 別名 | const { name: uname } = user |
| デフォルト値 | const { age = 20 } = user |
| ネスト | const { addr: { city } } = user |
| 残り全部 | const [a, ...rest] = arr / const { id, ...others } = user |
サンプルコード(実行結果つき)
const user = { id: 1, name: 'Taro', addr: { city: 'Tokyo' } };
const { id, name } = user;
console.log(id, name); // 1 Taro
const { name: uname, age = 20 } = user;
console.log(uname, age); // Taro 20
const { addr: { city } } = user;
console.log(city); // Tokyo
const [a, , c = 9, ...rest] = [1, 2, undefined, 4, 5];
console.log(a, c, rest); // 1 9 [ 4, 5 ]
変数の入れ替え
let x = 1, y = 2;
[x, y] = [y, x];
console.log(x, y); // 2 1
関数の引数で使う
function f({ w = 100, h = 50 } = {}) { return w * h; }
console.log(f(), f({ w: 10 })); // 5000 500
末尾の = {} は、引数なしで呼ばれたときのエラー防止です。
ループで使う
for (const [k, v] of Object.entries({ p: 1, q: 2 })) console.log(k, v);
// p 1
// q 2
残りを取り出す(オブジェクト)
const { name: n2, ...others } = user;
console.log(others); // { id: 1, addr: { city: 'Tokyo' } }
エラーになる例と、デフォルト値の落とし穴
const { z } = null; // TypeError: Cannot destructure property 'z' of 'null' as it is null.
const [m] = undefined; // TypeError: undefined is not iterable
const { a: q = 5 } = { a: null };
console.log(q); // null (デフォルト値は undefined のときだけ使われる)
動作確認(検証環境と結果)
- 環境: Node.js v24.19.0(Windows 11)
- すべて実行し、上記コメントの出力と一致することを確認。
'hello'からconst { length } = 'hello'で5が取れることも確認。 - 検証ログ:
C:Tempks2techtestsjs-destructuring.md - ブラウザでの実行は未検証(標準仕様のため同じ結果になる想定)。
分割代入の注意点
- 値が
nullやundefinedのときは分割代入でエラーになります。APIの戻り値は?? {}で保険をかけると安全です。 - デフォルト値が使われるのは
undefinedのときだけで、nullや0、空文字には適用されません。 - 文頭でオブジェクトの分割代入を宣言なしで書く場合、
({ a, b } = obj);のように丸括弧が必要です。 - 深いネストの分割代入は読みにくくなります。2階層程度に留めるのがおすすめです。
分割代入でよくあるミス
- 変数名がプロパティ名と違っていて
undefinedになる(別名の書き方{ a: b }を忘れている)。 - 別名の書き方で、左右を逆に書く(
{ 変数: プロパティ }ではなく{ プロパティ: 変数 })。 nullが返るAPIで、デフォルト値が効くと思い込む。- 同じ名前の変数が既にあるスコープで
const宣言して再宣言エラーになる。
ブラウザ対応・バージョン
ES2015 の機能で、現行の主要ブラウザで使えます。オブジェクトの残余プロパティ(...others)は ES2018 です。古い環境をサポートする場合は、MDN の互換性表とビルドツールの設定を確認してください。
分割代入のチェックリスト
- 変数名とプロパティ名が一致している(または別名を指定した)
null・undefinedが来る可能性がある値に保険を入れた- 引数のデフォルト値
= {}を付けた - ネストが深すぎない
分割代入のFAQ(よくある質問)
Q. 配列とオブジェクトで書き方が違うのはなぜ?
A. 配列は順番、オブジェクトは名前で値を対応させるためです。括弧が [ ] か { } かで区別します。
Q. 取り出した値を変えると元も変わりますか?
A. プリミティブ値(数値・文字列)はコピーなので変わりません。オブジェクトや配列は参照なので、中身を変えると元にも影響します。
Q. importの波括弧と同じですか?
A. 見た目は似ていますが、別の構文です。import { a } はモジュールの名前付きエクスポートを取り込むもので、分割代入ではありません。
筆者の見解(分割代入)
分割代入は、関数の引数に使うと効果が大きいと考えます。引数名が見える形になり、オプション引数のデフォルト値も一箇所にまとまるためです。一方でネストを深くしすぎると、かえってデータ構造が追いにくくなるので、私は2階層までを目安にしています。
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日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
分割代入の関連項目
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
