【Node.js24.x】Array::with()メソッドの使い方
withメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
withメソッドは、配列の指定されたインデックスにある要素を新しい値に置き換え、その結果として新しい配列を生成して返すメソッドです。このメソッドの最も重要な特徴は、元の配列（呼び出し元）を一切変更しない非破壊的な操作である点です。既存の配列のコピーを作成し、そのコピー内で指定された要素だけを置き換えるため、元のデータ構造を安全に保ちながら変更を適用できます。
第一引数には、値を変更したい要素のインデックスを指定します。このインデックスは、0から始まる正の数値であるだけでなく、配列の末尾からの位置を示す負の数値（例: -1は最後の要素）も指定可能です。第二引数には、そのインデックス位置に設定したい新しい値を渡します。
もし指定されたインデックスが配列の有効な範囲外（例えば、配列の長さを超えるインデックスや、配列の先頭よりも前の負のインデックス）である場合、RangeErrorがスローされます。これにより、誤ったインデックス指定による予期せぬ挙動を防ぎ、安全なプログラミングを促進します。このメソッドは、特に元のデータを不変（immutable）に保ちたい状態管理や、副作用のない関数型プログラミングのスタイルで配列を操作する際に非常に有用です。
構文(syntax)
1const originalArray = [10, 20, 30, 40]; 2const newArray = originalArray.with(1, 25); 3console.log(newArray); // [10, 25, 30, 40] 4console.log(originalArray); // [10, 20, 30, 40]
引数(parameters)
index, value
- index: number: 更新する要素のインデックス
- value: any: 設定する新しい値
戻り値(return)
Array
Array.prototype.with(index, value) メソッドは、指定したインデックスの要素を指定した値で置き換えた新しい配列を返します。元の配列は変更されません。