【Node.js24.x】Array::toSpliced()メソッドの使い方

toSplicedメソッドは、配列から要素を削除、追加、または置換することで、元の配列を変更せずに新しい配列を作成するメソッドです。このメソッドは、配列操作における「非破壊的」な手法を提供し、元のデータ構造を保ちたい場合に特に有用です。

具体的には、配列の指定された開始位置から特定の数の要素を削除し、任意で新しい要素をその位置に挿入します。引数としては、変更を開始する配列のインデックスを表すstart、削除する要素の数を表すdeleteCount、そして任意で追加したい要素を表すitem1, item2, ... を受け取ります。

start引数には、変更を開始するゼロベースのインデックスを指定します。負の値を指定すると、配列の末尾からのオフセットとして扱われます。deleteCount引数には、startの位置から削除する要素の数を指定します。この引数を省略したり、0未満の値を指定すると、start以降のすべての要素が削除されます。0を指定した場合、要素は削除されず、新しい要素が挿入されるのみとなります。

追加する要素（item1, item2, ...）は、削除された要素の代わりに、または削除がない場合にstartの位置に挿入されます。これらの引数を省略した場合、要素の追加は行われません。

JavaScriptのArray.prototype.splice()メソッドとは異なり、toSplicedメソッドは元の配列を直接変更しません。常に新しい配列を返すため、元のデータが意図せず変更されることを防ぎ、コードの安全性と予測可能性を高めます。Immutableなデータ操作が求められるモダンなシステム開発において、データの整合性を保ちつつ配列を操作する際に非常に有効なメソッドです。

Copy
1const originalArray = [10, 20, 30, 40, 50];
2const newArray = originalArray.toSpliced(2, 1, 60, 70);

start, deleteCount, ...items

• start: number: 配列を変更する開始位置を指定する整数
• deleteCount: number: 削除する要素の数を指定する整数
• ...items: any[]: 配列に追加する要素のリスト

Array

元の配列を変更せずに、指定されたインデックスから指定された数の要素を削除し、指定された要素を挿入した新しい配列を返します。