JavaScriptで配列の先頭に要素を追加したい場合、`unshift()`メソッドを使用します。この記事では、`unshift()`メソッドの基本的な使い方から実践的な例まで、わかりやすく解説します。

unshift()メソッドとは

`unshift()`は、配列の先頭に1つまたは複数の要素を追加するメソッドです。追加後の配列の新しい長さを返します。

基本的な使い方

const fruits = ['りんご', 'バナナ'];
const newLength = fruits.unshift('みかん');

console.log(fruits);     // ['みかん', 'りんご', 'バナナ']
console.log(newLength);  // 3

複数の要素を追加する

const numbers = [3, 4, 5];
numbers.unshift(1, 2);

console.log(numbers);  // [1, 2, 3, 4, 5]

実践的な使用例

1. 優先タスクの追加

const taskList = ['メール確認', '会議'];
taskList.unshift('緊急タスク');

console.log(taskList);  // ['緊急タスク', 'メール確認', '会議']

2. 配列の結合

const mainList = ['B', 'C'];
const prefixItems = ['A'];
mainList.unshift(...prefixItems);

console.log(mainList);  // ['A', 'B', 'C']

注意点

1. 元の配列が変更される

- `unshift()`は破壊的メソッドで、元の配列を直接変更します。

2. 戻り値

- メソッドは新しい配列の長さを返します。

3. パフォーマンス

- 大きな配列での使用は、要素の再インデックス付けが必要なため、パフォーマンスに影響を与える可能性があります。

代替手段

配列を変更したくない場合は、スプレッド構文を使用する方法があります:

const original = [2, 3];
const newArray = [1, ...original];

console.log(newArray);  // [1, 2, 3]

まとめ

`unshift()`メソッドは、配列の先頭に要素を追加する簡単で効果的な方法です。単一または複数の要素を追加でき、新しい配列の長さを返します。ただし、大きな配列での使用時はパフォーマンスに注意が必要です。

以上で、JavaScriptの`unshift()`メソッドについての解説を終わります。このメソッドを使いこなすことで、より柔軟な配列操作が可能になります。