Code Explain

Geminiの鋭い視点と分かりやすい解説で、プログラミングスキルを向上させましょう!

【徹底解説】JavaScript配列の安全なコピー術:sliceメソッドの活用からシャロー・ディープコピーまで

JavaScriptで配列を扱っていると、「配列をコピーしたはずなのに、元の配列まで変わってしまった…」という経験はありませんか?もし「ある!」と答えたなら、それはあなたがJavaScriptの配列における「参照渡し」という重要な概念に直面した証拠です。

この記事では、そんなJavaScript配列のコピーにまつわる悩みを根本から解決します。特に、配列コピーの基本中の基本であるslice()メソッドに焦点を当て、その使い方から「シャローコピー」という概念、そしてさらに踏み込んだ「ディープコピー」の必要性まで、網羅的に解説していきます。

この記事を読めば、あなたはJavaScriptの配列コピーを完全にマスターし、意図しないバグに悩まされることなく、安全かつ効率的なデータ操作を実現できるようになるでしょう。

さあ、JavaScript配列コピーの奥義を解き明かし、あなたのコードを次のレベルへと引き上げましょう!

1. JavaScriptにおける配列の基本:なぜコピーが難しいのか?「参照渡し」の罠

JavaScriptには、データを扱う際に大きく分けて二つの型があります。「プリミティブ型」と「オブジェクト型」です。この二つの型の違いを理解することが、配列コピーの難しさ、ひいては「参照渡し」の概念を理解する上で不可欠です。

  • プリミティブ型 (Primitive Types):

    • number, string, boolean, null, undefined, symbol, bigint
    • これらは「値」そのものが変数に格納されます。変数を別の変数に代入すると、値そのものがコピーされます。
    • 例: let a = 10; let b = a; a = 20; としても b10 のままです。
  • オブジェクト型 (Object Types):

    • object (通常のオブジェクト、配列、関数なども含む)
    • これらは「値そのもの」が変数に格納されるのではなく、「値が保存されているメモリ上の場所(参照)」が変数に格納されます。
    • つまり、変数を別の変数に代入すると、コピーされるのは「参照」であり、実体は一つしか存在しません。

そして、JavaScriptの配列はオブジェクト型の一種です。これが「配列をコピーしたつもりが、元の配列まで変わってしまう」という問題の根本原因となります。

以下のコードを見てください。

let originalArray = [10, 20, 30];
let copiedArray = originalArray; // ここで参照がコピーされる!

console.log('--- 初期状態 ---');
console.log('originalArray:', originalArray); // [10, 20, 30]
console.log('copiedArray:', copiedArray);   // [10, 20, 30]

copiedArray.push(40); // copiedArrayに変更を加える

console.log('--- 変更後 ---');
console.log('originalArray:', originalArray); // [10, 20, 30, 40] ← originalArrayも変わってしまった!
console.log('copiedArray:', copiedArray);   // [10, 20, 30, 40]

この例では、originalArraycopiedArrayに代入しただけですが、copiedArrayに要素を追加すると、なんとoriginalArrayも一緒に変更されてしまいました。これは、originalArraycopiedArray同じメモリ上の配列を参照しているためです。まるで一つの部屋に二つの入口があるようなもので、どちらの入口から入っても同じ部屋にアクセスし、部屋の中の物を変更できるのと一緒です。

このような挙動を「参照渡し(Pass by Reference)」と呼びます。この問題を回避し、完全に独立した配列のコピーを作成するために、様々なコピー方法が必要になります。その中でも、最も基本的で広く使われているのがslice()メソッドです。

2. 配列を安全に「シャローコピー」する:slice()メソッドの徹底解説

slice()メソッドは、JavaScriptの配列から新しい配列を生成するための非常に便利なメソッドです。最も重要な点は、slice()元の配列を変更しない(非破壊的)という特性を持っていることです。そして、このメソッドが生成するのは「シャローコピー」と呼ばれる種類のコピーです。

2.1. slice()の基本的な使い方

slice()メソッドは、引数によってコピーする範囲を指定できます。引数を指定しない場合、配列全体がコピーされます。

引数なし:配列全体をコピー

最もシンプルなslice()の使い方は、引数を何も指定しない方法です。この場合、元の配列のすべての要素を新しい配列にコピーします。

const originalArray = [10, 20, 30, 40, 50];
const copiedArray = originalArray.slice();

console.log('元の配列:', originalArray); // [10, 20, 30, 40, 50]
console.log('コピーされた配列:', copiedArray); // [10, 20, 30, 40, 50]

// コピーされた配列を変更しても、元の配列には影響しない
copiedArray.push(60);
console.log('コピー変更後 - 元の配列:', originalArray); // [10, 20, 30, 40, 50]
console.log('コピー変更後 - コピーされた配列:', copiedArray); // [10, 20, 30, 40, 50, 60]

このように、slice()を使って作成されたcopiedArrayは、originalArrayとは異なる、独立した新しい配列であることがわかります。これが「参照渡し」の問題を解決する第一歩です。

slice(startIndex):指定したインデックスから最後までをコピー

slice()に1つの引数(startIndex)を指定すると、そのインデックスから配列の最後までをコピーして新しい配列を作成します。

const fruits = ['Apple', 'Banana', 'Cherry', 'Date', 'Elderberry'];

const slicedFruits1 = fruits.slice(2); // インデックス2 ('Cherry') から最後まで
console.log(slicedFruits1); // ['Cherry', 'Date', 'Elderberry']

const slicedFruits2 = fruits.slice(0); // インデックス0から最後まで (引数なしと同じ効果)
console.log(slicedFruits2); // ['Apple', 'Banana', 'Cherry', 'Date', 'Elderberry']

slice(startIndex, endIndex):指定した範囲をコピー

2つの引数(startIndexendIndex)を指定すると、startIndexからendIndexの直前までの要素をコピーします。endIndexで指定した要素は含まれないことに注意してください。

const animals = ['Cat', 'Dog', 'Elephant', 'Fox', 'Giraffe'];

const slicedAnimals1 = animals.slice(1, 4); // インデックス1から4の直前まで ('Dog', 'Elephant', 'Fox')
console.log(slicedAnimals1); // ['Dog', 'Elephant', 'Fox']

const slicedAnimals2 = animals.slice(0, 2); // インデックス0から2の直前まで ('Cat', 'Dog')
console.log(slicedAnimals2); // ['Cat', 'Dog']

負のインデックスの利用

startIndexendIndexには負の値を指定することもできます。負の値は配列の末尾からの位置を表します。

  • -1は最後の要素
  • -2は最後から2番目の要素 ...といった具合です。
const numbers = [10, 20, 30, 40, 50];

const slicedNumbers1 = numbers.slice(-3); // 最後から3番目 (30) から最後まで
console.log(slicedNumbers1); // [30, 40, 50]

const slicedNumbers2 = numbers.slice(-4, -1); // 最後から4番目 (20) から最後から1番目 (50) の直前まで
console.log(slicedNumbers2); // [20, 30, 40]

2.2. 「シャローコピー」とは何か?slice()の限界

slice()メソッドは新しい配列を作成し、元の配列を直接変更しないため、安全なコピー方法のように見えます。しかし、slice()が生成するのはあくまでも「シャローコピー(Shallow Copy)」です。この「シャローコピー」という概念を理解することが、JavaScript配列コピーの真髄を理解する上で非常に重要になります。

シャローコピーとは: 配列の要素がプリミティブ型(数値、文字列、真偽値など)であれば、その値が完全に新しい配列にコピーされます。しかし、配列の要素がオブジェクト型(別の配列、オブジェクトなど)である場合、slice()そのオブジェクトへの「参照」をコピーします。つまり、内側のオブジェクト自体は新しく作成されず、元の配列とコピーされた配列が同じ内側のオブジェクトを参照することになります。

このシャローコピーの挙動を、具体的なコードで見てみましょう。

const originalData = [
    1,
    'hello',
    true,
    [10, 20],      // 配列(オブジェクト型)
    { name: 'Alice', age: 30 } // オブジェクト(オブジェクト型)
];

const shallowCopiedData = originalData.slice();

console.log('--- シャローコピー直後 ---');
console.log('originalData:', originalData);
console.log('shallowCopiedData:', shallowCopiedData);
console.log('-------------------------');

// 1. プリミティブ型の要素を変更した場合
shallowCopiedData[0] = 999;
shallowCopiedData[1] = 'world';

console.log('\n--- プリミティブ型要素変更後 ---');
console.log('originalData[0]:', originalData[0]);       // 1 (変更なし)
console.log('shallowCopiedData[0]:', shallowCopiedData[0]); // 999
console.log('originalData[1]:', originalData[1]);       // 'hello' (変更なし)
console.log('shallowCopiedData[1]:', shallowCopiedData[1]); // 'world'
console.log('-------------------------');
// → プリミティブ型は独立してコピーされていることがわかる

// 2. オブジェクト型の要素(内側の配列)を変更した場合
shallowCopiedData[3].push(30); // コピーされた配列の内側の配列を変更
shallowCopiedData[3][0] = 100; // コピーされた配列の内側の配列の要素を変更

console.log('\n--- 内側の配列要素変更後 ---');
console.log('originalData[3]:', originalData[3]);       // [100, 20, 30] ← 元の配列も変わってしまった!
console.log('shallowCopiedData[3]:', shallowCopiedData[3]); // [100, 20, 30]
console.log('-------------------------');
// → 内側の配列は参照がコピーされただけなので、元の配列も影響を受ける

// 3. オブジェクト型の要素(内側のオブジェクト)を変更した場合
shallowCopiedData[4].age = 40; // コピーされた配列の内側のオブジェクトのプロパティを変更
shallowCopiedData[4].city = 'Tokyo'; // コピーされた配列の内側のオブジェクトにプロパティを追加

console.log('\n--- 内側のオブジェクト要素変更後 ---');
console.log('originalData[4]:', originalData[4]);       // { name: 'Alice', age: 40, city: 'Tokyo' } ← 元の配列も変わってしまった!
console.log('shallowCopiedData[4]:', shallowCopiedData[4]); // { name: 'Alice', age: 40, city: 'Tokyo' }
console.log('-------------------------');
// → 内側のオブジェクトも参照がコピーされただけなので、元の配列も影響を受ける

この例からわかるように、slice()を使ったシャローコピーは、配列の第一階層にある要素(プリミティブ型)は安全にコピーしますが、第二階層以降にあるオブジェクト(配列やオブジェクト)は参照がコピーされるだけなので、それらの内側のデータを変更すると、元の配列にも影響が及んでしまいます。

この挙動こそが、JavaScriptの配列コピーにおける「あるあるバグ」の温床となりやすいポイントです。

3. slice()メソッドのメリットと限界(シャローコピーの真実)

slice()メソッドは、JavaScriptの配列コピーにおいて非常に有用ですが、その特性を理解して適切に使いこなすことが重要です。

3.1. slice()メソッドのメリット

  1. シンプルで直感的: 引数なしで簡単に配列全体のコピーを作成できます。部分的なコピーもインデックス指定で容易に行えます。
  2. 非破壊的メソッド: 元の配列を一切変更しないため、安全に新しい配列を作成できます。これは、Reactなどのフレームワークで「不変性(Immutability)」を保つために非常に重要な特性です。
  3. 新しい配列を返す: 常に新しい配列インスタンスを生成するため、異なる参照を持つ配列として扱えます。
  4. パフォーマンスが良い: 特に配列の第一階層にある要素のコピーにおいて、シンプルかつ高速です。
  5. 幅広い用途: 配列全体をコピーするだけでなく、特定の部分を切り出して新しい配列として扱う際にも便利です。

3.2. slice()メソッドの限界(シャローコピーの真実)

前述したように、slice()の最大の限界は、それが「シャローコピー」であるという点です。

  • ネストされたオブジェクトや配列の変更が元の配列に影響する: 配列の要素として別の配列やオブジェクトが含まれている場合、slice()はそれらの内側のオブジェクトを複製するのではなく、そのオブジェクトへの参照をコピーします。したがって、コピーされた配列を介して内側のオブジェクトを変更すると、元の配列も影響を受けてしまいます。 これは、特にオブジェクトの階層が深い場合や、複雑なデータ構造を扱う場合に、意図しないバグの温床となります。

この限界を理解し、いつシャローコピーで十分なのか、いつディープコピーが必要なのかを判断する能力が、プロフェッショナルなJavaScript開発者には求められます。

4. slice()だけじゃない!JavaScript配列のコピー方法を徹底比較

slice()以外にも、JavaScriptには配列をコピーするための様々な方法があります。それぞれに特徴があり、slice()と同様に「シャローコピー」として機能するものがほとんどです。ここでは、主要なコピー方法を比較し、その挙動と使い分けを見ていきましょう。

4.1. スプレッド構文 (...) を使ったコピー

ES2015(ES6)で導入されたスプレッド構文は、配列やオブジェクトを展開するための非常に強力な機能です。配列のコピーにも非常に頻繁に利用されます。

const originalArray = [1, 2, 3];
const copiedArray = [...originalArray]; // スプレッド構文でコピー

console.log('元の配列:', originalArray); // [1, 2, 3]
console.log('コピーされた配列:', copiedArray); // [1, 2, 3]

copiedArray.push(4);
console.log('変更後 - 元の配列:', originalArray); // [1, 2, 3]
console.log('変更後 - コピーされた配列:', copiedArray); // [1, 2, 3, 4]

特徴:

  • 簡潔さ: [...originalArray]という非常に短い記述でコピーが可能です。
  • シャローコピー: slice()と同様に、シャローコピーです。内側のオブジェクトは参照がコピーされます。
  • 可読性: 現代のJavaScriptコードで非常によく使われるため、可読性も高いです。
  • 他の配列との結合: [...arr1, ...arr2]のように複数の配列を結合する際にも便利です。
  • オブジェクトのコピー: オブジェクトに対しても同様にシャローコピーが可能です({...originalObject})。

スプレッド構文は、slice()と機能的にはほぼ同じですが、より簡潔で現代的な記述として好まれる傾向にあります。

4.2. Array.from() を使ったコピー

Array.from()メソッドは、イテラブルな(反復可能な)オブジェクトや、配列のようなオブジェクトから、新しいArrayインスタンスを生成します。

const originalArray = [1, 2, 3];
const copiedArray = Array.from(originalArray); // Array.from()でコピー

console.log('元の配列:', originalArray); // [1, 2, 3]
console.log('コピーされた配列:', copiedArray); // [1, 2, 3]

copiedArray.push(4);
console.log('変更後 - 元の配列:', originalArray); // [1, 2, 3]
console.log('変更後 - コピーされた配列:', copiedArray); // [1, 2, 3, 4]

特徴:

  • シャローコピー: これもslice()やスプレッド構文と同様にシャローコピーです。
  • イテラブルオブジェクトからの生成: 文字列(Array.from('hello') -> ['h', 'e', 'l', 'l', 'o'])やSetMapなど、様々なイテラブルなデータ構造から配列を生成するのに使えます。
  • マッピング機能: 第2引数に関数を渡すことで、コピーと同時に要素を変換(マッピング)することも可能です。
    const numbers = [1, 2, 3];
    const doubledNumbers = Array.from(numbers, num => num * 2);
    console.log(doubledNumbers); // [2, 4, 6]
    

配列のコピー目的であれば、スプレッド構文の方が一般的に使用されますが、イテラブルオブジェクトからの変換やマッピングを伴うコピーにはArray.from()が有用です。

4.3. concat() メソッドを使ったコピー

concat()メソッドは、既存の配列に別の配列や値を追加して、新しい配列を生成します。この特性を利用して、配列全体をコピーすることも可能です。

const originalArray = [1, 2, 3];
const copiedArray = [].concat(originalArray); // 空配列に元の配列を結合してコピー

console.log('元の配列:', originalArray); // [1, 2, 3]
console.log('コピーされた配列:', copiedArray); // [1, 2, 3]

copiedArray.push(4);
console.log('変更後 - 元の配列:', originalArray); // [1, 2, 3]
console.log('変更後 - コピーされた配列:', copiedArray); // [1, 2, 3, 4]

特徴:

  • シャローコピー: slice()やスプレッド構文と同様にシャローコピーです。
  • 複数の配列結合: 複数の配列を結合する際に非常に便利です(arr1.concat(arr2, arr3))。
  • 互換性: 以前から存在するメソッドなので、古いJavaScript環境でも問題なく動作します。

concat()はシンプルで信頼性がありますが、配列のコピー単体で考えるとスプレッド構文の方がより簡潔に記述できます。

4.4. ループを使った手動コピー (参考)

forループやforEachループを使って、配列の要素を一つずつ新しい配列に追加していくことで、手動でコピーすることも可能です。

const originalArray = [1, 2, 3];
const copiedArray = [];
for (let i = 0; i < originalArray.length; i++) {
    copiedArray.push(originalArray[i]);
}
// または originalArray.forEach(item => copiedArray.push(item));

console.log('元の配列:', originalArray); // [1, 2, 3]
console.log('コピーされた配列:', copiedArray); // [1, 2, 3]

特徴:

  • シャローコピー: この方法もシャローコピーです。
  • 明示的: コピーのプロセスが明確に記述されます。
  • 冗長: 他の方法に比べて記述が長くなり、現代のJavaScriptではあまり推奨されません。

これは主に教育目的や、ごく特定のパフォーマンス最適化(稀なケース)で考慮される程度で、日常的な配列コピーには上記のスプレッド構文やslice()が推奨されます。

まとめ:slice()もスプレッド構文もArray.from()concat()も、全て「シャローコピー」です。 これらの方法では、配列がネストされたオブジェクトや配列を含む場合、内側のデータまで完全に独立してコピーすることはできません。この限界を理解し、ディープコピーが必要な状況では次のセクションで紹介する方法を検討する必要があります。

5. シャローコピーでは不十分な場合:ディープコピーへの道

シャローコピーが「第一階層のコピー」であるのに対し、「ディープコピー(Deep Copy)」は、ネストされたオブジェクトや配列を含むすべての階層のデータを完全に独立して複製することを指します。これにより、元のデータとコピーされたデータの間に何の参照も残らず、完全に独立した操作が可能になります。

ディープコピーはシャローコピーよりも複雑で、いくつかの方法がありますが、それぞれにメリット・デメリットがあります。

5.1. JSONオブジェクトを使った簡易ディープコピー (JSON.parse(JSON.stringify()))

最も手軽にディープコピーを実現できる方法の一つが、JSON.stringify()でオブジェクトをJSON文字列に変換し、その文字列をJSON.parse()で再度オブジェクトに戻す方法です。

const originalObject = {
    a: 1,
    b: 'hello',
    c: [10, 20],
    d: { x: 100, y: 200 }
};

const deepCopiedObject = JSON.parse(JSON.stringify(originalObject));

console.log('--- JSONディープコピー直後 ---');
console.log('originalObject:', originalObject);
console.log('deepCopiedObject:', deepCopiedObject);
console.log('----------------------------');

deepCopiedObject.d.x = 999; // コピーされたオブジェクトのネストされたプロパティを変更

console.log('\n--- JSONディープコピー変更後 ---');
console.log('originalObject.d.x:', originalObject.d.x);     // 100 (変更なし!)
console.log('deepCopiedObject.d.x:', deepCopiedObject.d.x); // 999
console.log('----------------------------');

この例では、deepCopiedObjectの内側のプロパティを変更しても、originalObjectには全く影響がないことがわかります。

メリット:

  • 手軽さ: 非常にシンプルなコードでディープコピーが実現できます。
  • 広く利用可能: JSONオブジェクトはJavaScriptの標準機能であり、ほとんどの環境で利用可能です。

デメリット:

  • データ型の制限:
    • 関数 (function)、undefinedsymbolはコピー時に失われます。
    • Dateオブジェクトは文字列に変換されます("2023-10-27T10:00:00.000Z"のようなISO文字列)。
    • RegExpオブジェクトも空のオブジェクト {} に変換されます。
    • Map, Setなどの一部のビルトインオブジェクトは、空のオブジェクト {} に変換されます。
  • 循環参照に対応しない: オブジェクトが自分自身を間接的に参照している(循環参照)場合、JSON.stringify()はエラーを発生させます。
  • パフォーマンス: 大規模なデータ構造の場合、文字列への変換と解析に時間がかかり、パフォーマンスが低下する可能性があります。

この方法は「手軽なディープコピー」として非常に便利ですが、上記のようなデメリットを理解し、データ構造がシンプルな場合に限定して使用することが推奨されます。

5.2. structuredClone() を使ったディープコピー (ES2022)

ECMAScript 2022で導入されたstructuredClone()関数は、JavaScriptに待望の標準的なディープコピー機能を提供します。これは、ブラウザ環境(window.structuredClone)とNode.js環境で利用可能です。

const originalData = {
    id: 1,
    details: {
        name: 'John Doe',
        email: 'john@example.com',
        hobbies: ['reading', 'coding'],
        registeredAt: new Date()
    },
    // someFunction: () => console.log('This will be ignored by structuredClone')
};

const deepCopiedData = structuredClone(originalData);

console.log('--- structuredClone直後 ---');
console.log('originalData:', originalData);
console.log('deepCopiedData:', deepCopiedData);
console.log('-------------------------');

// コピーされたデータを変更
deepCopiedData.details.name = 'Jane Doe';
deepCopiedData.details.hobbies.push('hiking');
deepCopiedData.details.registeredAt.setFullYear(2024);

console.log('\n--- structuredClone変更後 ---');
console.log('originalData.details.name:', originalData.details.name);           // 'John Doe' (変更なし!)
console.log('deepCopiedData.details.name:', deepCopiedData.details.name);       // 'Jane Doe'
console.log('originalData.details.hobbies:', originalData.details.hobbies);       // ['reading', 'coding'] (変更なし!)
console.log('deepCopiedData.details.hobbies:', deepCopiedData.details.hobbies);   // ['reading', 'coding', 'hiking']
console.log('originalData.details.registeredAt:', originalData.details.registeredAt.getFullYear()); // 変更前
console.log('deepCopiedData.details.registeredAt:', deepCopiedData.details.registeredAt.getFullYear()); // 変更後
console.log('-------------------------');

メリット:

  • 標準機能: JavaScriptの組み込み関数であり、外部ライブラリを必要としません。
  • 広範なデータ型に対応: Date, RegExp, Map, Set, ArrayBuffer, Blob, File, ImageDataなど、多くのビルトインオブジェクトやデータ型を適切にコピーできます。
  • 循環参照に対応: 循環参照を持つオブジェクトもコピー可能で、エラーを発生させません(ただし、循環参照は新しいオブジェクトで再現されます)。
  • シンプル: 1つの関数呼び出しでディープコピーが完了します。

デメリット:

  • 関数のコピーは不可: JSON.parse(JSON.stringify())と同様に、関数はコピーされず無視されます。
  • 特定のオブジェクトはコピー不可: DOMノード、プロパティディスクリプタ、ゲッター/セッター、エラーオブジェクトなどはコピーできません。
  • 比較的新しい機能: ES2022で導入されたため、古いブラウザやNode.jsのバージョンでは利用できない場合があります。利用する際は互換性を確認する必要があります(Can I use structuredClone? で確認できます)。

structuredClone()は、これまでのディープコピーの課題の多くを解決する強力なツールです。対応環境であれば、最も推奨されるディープコピーの方法と言えるでしょう。

5.3. 外部ライブラリ (Lodashの cloneDeep など)

より複雑なデータ構造や、古いJavaScript環境での互換性を維持しつつ堅牢なディープコピーが必要な場合は、Lodashのようなユーティリティライブラリが提供するcloneDeep関数が非常に有効です。

// npm install lodash を実行後
// import { cloneDeep } from 'lodash'; // ES Modulesの場合
const _ = require('lodash'); // CommonJSの場合

const originalDataWithFunction = {
    id: 1,
    process: function() { console.log('処理中...'); },
    config: {
        retries: 3
    }
};

const deepCopiedData = _.cloneDeep(originalDataWithFunction);

console.log('--- Lodash cloneDeep直後 ---');
console.log('originalDataWithFunction:', originalDataWithFunction);
console.log('deepCopiedData:', deepCopiedData);
console.log('-------------------------');

deepCopiedData.config.retries = 5;
// deepCopiedData.process(); // コピーされた関数も実行可能

console.log('\n--- Lodash cloneDeep変更後 ---');
console.log('originalDataWithFunction.config.retries:', originalDataWithFunction.config.retries); // 3 (変更なし!)
console.log('deepCopiedData.config.retries:', deepCopiedData.config.retries);     // 5
console.log('-------------------------');

メリット:

  • 堅牢性: JSON.parse(JSON.stringify())structuredClone()が扱えない多くのデータ型(関数、プロパティディスクリプタなど)をコピーできます。
  • 古い環境での互換性: 古いJavaScript環境でもディープコピーを実現できます。
  • 高い信頼性: 長年の開発とコミュニティによって信頼性が確立されています。

デメリット:

  • 外部ライブラリの導入: プロジェクトにLodashをインストールし、バンドルサイズが増加します。
  • パフォーマンス: 非常に大きなオブジェクトや複雑な構造の場合、ネイティブな方法より遅くなる可能性があります。

ディープコピーのニーズが非常に複雑で、structuredClone()では対応しきれない場合、あるいは古い環境での互換性が必須な場合に、Lodashのような外部ライブラリが最も強力な選択肢となります。

6. シャローコピーとディープコピー:賢い使い分けのコツ

これまでの解説で、シャローコピーとディープコピーの概念、そしてそれぞれの具体的な方法を理解できたはずです。では、実際にどのような状況でどちらのコピー方法を選ぶべきなのでしょうか?

6.1. シャローコピー (slice(), スプレッド構文など) を使うべき時

シャローコピーは、シンプルで高速なため、不必要にディープコピーを使うよりもパフォーマンス面で優位です。

  • 配列の要素がすべてプリミティブ型の場合: [1, 'text', true] のように、配列の要素が数値、文字列、真偽値などのプリミティブ型のみである場合、シャローコピーで完全に独立した配列を作成できます。この場合、ディープコピーを使う必要はありません。
  • ネストされたオブジェクトや配列の変更が不要な場合: 配列がネストされたオブジェクトや配列を含んでいても、それらの内側のデータを変更する予定がない場合(例えば、表示用の一時的なデータとして使うだけで、元のデータを壊す心配がない場合)は、シャローコピーで十分です。
  • 「不変性(Immutability)」を保ちたいが、パフォーマンスも重視したい場合: ReactのsetStateなど、状態管理において「不変性」が求められる状況で、配列そのものの参照を変更する必要があるが、内側のオブジェクトは変更されないことが保証されている(または、immerのようなライブラリで管理されている)場合。
  • 部分的な配列を抽出したい場合: slice(startIndex, endIndex)のように、配列の一部を切り出して新しい配列を作成したい場合に最適です。

例:

const userIds = [101, 102, 103];
const newUserIds = userIds.slice(); // プリミティブ型なのでこれでOK
newUserIds.push(104);
console.log(userIds);    // [101, 102, 103]
console.log(newUserIds); // [101, 102, 103, 104]

6.2. ディープコピー (structuredClone(), JSON.parse(JSON.stringify()), ライブラリ) を使うべき時

ディープコピーは、シャローコピーでは解決できない、より複雑なシナリオで必要となります。

  • ネストされたオブジェクトや配列を含み、それらを完全に独立して変更したい場合: 配列の要素として別の配列やオブジェクトが含まれており、それらの内側のデータも、元の配列に影響を与えることなく自由に操作したい場合にディープコピーが必要です。これは、データの編集画面や、状態を完全に複製してバックアップを取りたい場合などに当てはまります。
  • 元のデータへの副作用を完全に排除したい場合: 複雑なデータ構造を関数に渡して操作する際、関数内で元のデータを一切変更させたくない場合にディープコピーを使用します。これにより、予期せぬバグを防ぎ、関数の純粋性を保つことができます。
  • 履歴管理やアンドゥ機能の実装: アプリケーションの状態を複数の時点で保存し、後から特定の時点に戻せるようにする(アンドゥ/リドゥ機能など)場合、各時点の状態をディープコピーして保存する必要があります。

例:

const userData = [
    { id: 1, name: 'Alice', settings: { theme: 'dark' } },
    { id: 2, name: 'Bob', settings: { theme: 'light' } }
];

// ユーザー1の情報を編集するが、元のデータには影響させたくない
// structuredCloneが最も堅牢
const updatedUserData = structuredClone(userData);
updatedUserData[0].name = 'Alicia';
updatedUserData[0].settings.theme = 'blue';

console.log(userData[0]);        // { id: 1, name: 'Alice', settings: { theme: 'dark' } }
console.log(updatedUserData[0]); // { id: 1, name: 'Alicia', settings: { theme: 'blue' } }

6.3. 選択のポイントとベストプラクティス

  1. デフォルトはシャローコピーを検討: まずはslice()やスプレッド構文などを使ったシャローコピーで十分かどうかを検討しましょう。シンプルさとパフォーマンスの観点から、これが最初の選択肢となるべきです。
  2. ネストされたオブジェクトの有無と変更の意図を確認: 配列にオブジェクトや別の配列がネストされているか?そして、その内側のオブジェクトを「変更する可能性があるか?」がディープコピーが必要かどうかを判断する重要な質問です。
  3. データ構造とサポート環境でディープコピー方法を選ぶ:
    • シンプルなオブジェクトのみ: JSON.parse(JSON.stringify()) で十分な場合が多い(ただし関数やDate型に注意)。
    • 複雑なデータ型や循環参照に対応したい(現代の環境): structuredClone() が最も推奨されます。
    • 特定のデータ型(関数など)もコピーしたい、または古い環境をサポートしたい: LodashのcloneDeepのような外部ライブラリを検討します。
  4. 「不変性(Immutability)」の意識: データを直接変更するのではなく、常に新しいデータを生成するという考え方(不変性)は、JavaScriptで予測可能でバグの少ないコードを書く上で非常に重要です。コピー操作はそのための基本的な手段となります。

配列コピーはJavaScript開発の基礎であり、同時に奥深いテーマでもあります。それぞれのメソッドが持つ特性と限界を理解し、現在のデータ構造と要件に最適な方法を選択する能力を養いましょう。

7. まとめ:JavaScript配列コピーの未来とあなたのコード

この記事では、JavaScript配列のコピーという一見単純に見えるタスクが、実は「参照渡し」というJavaScriptの核心的な概念と密接に関わっていることを詳しく見てきました。

  1. 参照渡しの理解: 配列がオブジェクト型であるため、単純な代入では参照がコピーされるだけで、元の配列とコピーした配列が同じメモリを指してしまうことを学びました。これが多くのバグの原因となります。
  2. slice()メソッドの活用: slice()は、引数なしで配列全体を、または引数で指定した範囲を安全にコピーできる非常に便利なメソッドです。しかし、これが生成するのは「シャローコピー」であるという重要な限界も理解しました。
  3. シャローコピーの限界と他の方法: slice()、スプレッド構文(...)、Array.from()concat()といったシャローコピー手法は、配列の第一階層にあるプリミティブ型の要素は安全にコピーしますが、内側のオブジェクトや配列は参照がコピーされるため、変更が元のデータに影響を及ぼす可能性があります。
  4. ディープコピーの必要性: ネストされたオブジェクトや配列も完全に独立させたい場合は、「ディープコピー」が必要です。
    • JSON.parse(JSON.stringify()): 手軽ですが、コピーできないデータ型や循環参照の制約があります。
    • structuredClone() (ES2022): 現代の環境で最も推奨される標準的なディープコピー方法で、多くのデータ型や循環参照に対応します。
    • 外部ライブラリ (Lodash cloneDeep): 最も堅牢で柔軟ですが、ライブラリの導入が必要です。
  5. 賢い使い分け: 配列の要素がプリミティブ型のみか、ネストされたオブジェクトを修正する可能性があるかによって、シャローコピーかディープコピーかを判断し、適切な方法を選択することが重要です。

JavaScriptのバージョンアップに伴い、structuredClone()のような便利な標準機能が追加され、ディープコピーの選択肢もより明確になりました。しかし、これらの機能の根底にある「シャローコピー」と「ディープコピー」の概念、そしてJavaScriptの「参照渡し」の挙動を深く理解することが、堅牢で保守しやすいコードを書くための土台となります。

今、あなたのJavaScriptコードを振り返ってみてください。配列のコピーは正しく行われていますか?意図しない副作用に悩まされることなく、自信を持ってデータ操作ができるよう、この記事で学んだ知識をぜひ活用してください。

安全なデータ操作は、高品質なアプリケーション開発の第一歩です。この記事が、あなたのJavaScriptスキル向上の一助となれば幸いです。

\ この記事をシェア/
この記事を書いた人
pekemalu
I love codes. I also love prompts (spells). But I get a lot of complaints (errors). I want to be loved by both of you as soon as possible.
Image