オブジェクトのコピー方法浅い・深いコピーとstructuredClone
JavaScriptでオブジェクトや配列をコピーする方法を、スプレッド構文・Object.assign・JSON・structuredCloneで比較。浅いコピーと深いコピーの違いと失敗例を実行結果つきで整理します。
この記事の目次
オブジェクトのコピー方法とは
JavaScriptでは、オブジェクトと配列は参照で扱われるため、const b = a; と書いても複製にはならず、同じものを2つの名前で指しているだけです(値渡しと参照渡しを知りプログラムの挙動を正しく把握しよう【JavaScript入門】 も参照)。複製するには、コピーの深さを意識して方法を選ぶ必要があります。
- 浅いコピー: 1段目だけ複製。ネストした中身は元と共有される。
- 深いコピー: ネストも含めて完全に独立した複製を作る。
基本(構文・仕組み)
| 方法 | 深さ | 特徴 |
|---|---|---|
{ ...obj } / [...arr] |
浅い | 手軽。最も一般的 |
Object.assign({}, obj) |
浅い | スプレッド構文とほぼ同じ |
arr.slice() |
浅い | 配列のみ |
JSON.parse(JSON.stringify(obj)) |
深い | Date・Map・関数などが壊れる |
structuredClone(obj) |
深い | 標準。循環参照・Date・Map・Setに対応。関数は不可 |
サンプルコード(実行結果つき)
検証には次のデータを使いました。
const src = {
n: 1,
d: new Date('2026-01-01T00:00:00Z'),
a: { b: [1, 2] },
f() {},
u: undefined,
m: new Map([[1, 2]])
};
浅いコピーの失敗例
const s1 = { ...src };
s1.a.b.push(3);
console.log('浅い:', src.a.b); // 浅い: [ 1, 2, 3 ] ← 元も変わった
JSON方式の落とし穴
const j = JSON.parse(JSON.stringify(src));
console.log(j);
// { n: 1, d: '2026-01-01T00:00:00.000Z', a: { b: [ 1, 2, 3 ] }, m: {} }
Date は文字列に、Map は空のオブジェクトに変わり、関数と undefined は消えました(b が [1,2,3] なのは前の操作の影響です)。
structuredClone
const ok = { n: 1, d: new Date('2026-01-01T00:00:00Z'), a: { b: [1, 2] }, m: new Map([[1, 2]]) };
const sc = structuredClone(ok);
sc.a.b.push(3);
console.log(ok.a.b, sc.a.b, sc.d instanceof Date, sc.m);
// [ 1, 2 ] [ 1, 2, 3 ] true Map(1) { 1 => 2 }
Date も Map も型を保ったまま、元と独立した複製になりました。関数を含むと失敗します。
structuredClone(src);
// DataCloneError: f(){} could not be cloned.
循環参照
const cir = { name: 'x' }; cir.self = cir;
console.log(structuredClone(cir).self !== undefined); // true
JSON.stringify(cir); // TypeError: Converting circular structure to JSON
配列の中のオブジェクト
const arr = [{ v: 1 }];
const a2 = arr.slice();
a2[0].v = 9;
console.log(arr); // [ { v: 9 } ]
Object.freeze も浅い
const fz = Object.freeze({ a: { b: 1 } });
fz.a.b = 2; fz.c = 1;
console.log(fz); // { a: { b: 2 } } (1段目は凍結、ネストは変更できた)
非strictモード(Node.js の CommonJS で実行)では fz.c = 1 は黙って無視されます。strictモードやES Modulesでは TypeError になります。
動作確認(検証環境と結果)
- 環境: Node.js v24.19.0(Windows 11)
- 上記のコードを実行し、出力が一致することを確認(
DataCloneError、TypeErrorのメッセージも含む)。 - 検証ログ:
C:Tempks2techtestsjs-object-copy.md - ブラウザでの
structuredCloneは未検証です。対応バージョンは MDN/can I use で最新を確認してください。
オブジェクトのコピー方法の注意点
- 関数、DOM要素、クラスのメソッド(プロトタイプ)は
structuredCloneで複製できません。クラスのインスタンスは普通のオブジェクトになります。 - JSON方式は手軽ですが、型が変わる前提でないなら避けます。
- 本当に深いコピーが必要かを先に考えます。変更箇所だけを新しく作る(変更する枝だけスプレッドする)方が軽い場合があります。
オブジェクトのコピー方法でよくあるミス
const b = a;で複製した気になる。- スプレッドで深いコピーができたと思い込む。
- JSON方式で
Dateが文字列になってバグる。 Object.freezeを深い不変化と誤解する。
ブラウザ対応・バージョン
structuredClone は比較的新しいAPIで、MDN の互換性データでは Firefox 94(2021年)、Chrome 98・Safari 15.4(2022年)から対応しています。古い環境ではない前提かをMDNの互換性表で確認してください。Nodeでは v17 以降で利用できます(今回 v24 で確認)。
オブジェクトのコピー方法のチェックリスト
- 浅いコピーで足りるか、深いコピーが必要かを判断した
Date・Map・Set・関数を含むか確認した- コピー後に元のデータが変わっていないか確認した
- 循環参照の有無を確認した
オブジェクトのコピー方法のFAQ(よくある質問)
Q. 一番よく使う方法は?
A. 日常的にはスプレッド構文です。深い構造には structuredClone を使います。
Q. lodashの cloneDeep は必要?
A. 現在は structuredClone で多くの場合まかなえます。関数やカスタムクラスの複製が必要な場合のみ、ライブラリを検討します。
Q. 配列のコピーは?
A. [...arr] か arr.slice() が浅いコピー、structuredClone(arr) が深いコピーです。
筆者の見解(オブジェクトのコピー方法)
コピーの問題は、方法を覚えるより「どこまでを独立させたいか」を先に決める方が解決しやすいと考えます。私見では、日常の更新処理は浅いコピーで十分なことが多く、structuredClone は「元を絶対に壊したくない」場面に取っておく使い方が良いと思います。JSON方式はもはや第一候補にしなくて良いでしょう。
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日時点の公式サイトの記載です。料金・サポート範囲・返金の可否は変わることがあるため、申込前に公式サイトと特定商取引法の表記で最新の条件をご確認ください。
オブジェクトのコピー方法の関連項目
- スプレッド構文
- 値渡しと参照渡しを知りプログラムの挙動を正しく把握しよう【JavaScript入門】
- let・const・var
- 分割代入
- 膨大なデータの管理に便利!配列とオブジェクトを学ぼう!【JavaScript入門】
出典(一次情報)
本記事は情報提供を目的としています。ブラウザの仕様やライブラリのバージョンによって動作が異なる場合があるため、実際の開発では公式ドキュメントも合わせてご確認ください。
