unshiftメソッド

メソッド unshift は、配列の先頭に新しい要素を無制限に追加します。 このとき元の配列は変更され、メソッドの戻り値として配列の新しい長さが返されます。

構文

javascript配列.unshift(要素, 要素, 要素...);

例

配列の先頭にさらに2つの新しい要素を追加し、変更された配列を出力してみましょう:

javascriptlet arr = ['a', 'b', 'c', 'd', 'e'];
arr.unshift('1', '2');

console.log(arr);

コードの実行結果:

javascript['1', '2', 'a', 'b', 'c', 'd', 'e']

例

2つの新しい要素を追加し、配列の新しい長さを出力してみましょう:

javascriptlet arr = ['a', 'b', 'c', 'd', 'e'];
let length = arr.unshift('1', '2');

console.log(length);

コードの実行結果:

javascript7

関連項目

  • メソッド push,
    配列の末尾に要素を追加します
  • メソッド shift と pop,
    配列から要素を削除します
  • メソッド fill,
    配列を埋めます