【JSリファレンス】Array.prototype.unshift()

更新日：2024/06/14

Array.prototype.unshift()は、Arrayオブジェクト(Arrayコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。
配列の先頭に任意の個数の要素を追加して、追加後のlengthプロパティを返します。

※元となる配列の内容が変更されます。

 

■構文


Array.prototype.unshift ( ...items )
  1. ...items: 追加する値の羅列
追加後のlengthプロパティの値

 

■使用例

const array = [1,2,,4,,,];
console.log( array.unshift( 5,6,7 ) ); // 8
console.log( array ); 
  // [ 5, 6, 7, 1, 2, <1 empty item>, 4, <2 empty items> ]

 

■備考

call()等でアレイライクオブジェクトを対象にすることも可能です。

const arrayLike = { 0:1 ,1:2 , 2:3, length:3 };
console.log( Array.prototype.unshift.call( arrayLike , 5,6 ) );
  // 5
console.log( arrayLike );
  // { '0': 5, '1': 6, '2': 1, '3': 2, '4': 3, length: 5 }

更新日：2024/06/14

書いた人（管理人）：けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない？」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。