.unshift()
unshift()メソッドは、1つ以上の要素を配列の先頭に追加し、配列の新しいlengthを返します。
文法
arr.unshift(element1, ..., elementN)
| 引数 | 説明 |
|---|---|
| element1, ..., elementN | 配列の先頭へ追加する要素を指定します。 |
| 戻り値 | |
メソッドが呼び出されたオブジェクトの、新しいlengthプロパティを返します。
|
|
説明
unshiftメソッドは与えられた値を、配列(または、配列のような)オブジェクトの先頭に追加します。
unshiftは意図的に汎用的になっていて、
このメソッドは配列にう維持するオブジェクトからcall、
またはapplyすることが可能です。
一連の繋がりの最後を反映するものである、lengthプロパティを含まないオブジェクトでは、
0ベースの数値プロパティが、意味のある挙動を行わないかもしれません。
var arr = [1, 2];
arr.unshift(0);
// 呼び出しの結果は、配列の新しいlengthの値、
// ここでは3になります。
// 配列の結果: [0, 1, 2]
arr.unshift(-2, -1); // = 5
// 配列の結果: [-2, -1, 0, 1, 2]
arr.unshift( [-3] );
// 配列の結果: [[-3], -2, -1, 0, 1, 2]
仕様
ブラウザ互換性
| 機能 | Chrome | Firefox (Gecko) |
IE | Opera | Safari |
|---|---|---|---|---|---|
| 基本 | 1.0 | 1.0 (1.7 or earlier) | 5.5 | ◯ | ◯ |
| 機能 | Android | Chrome for Android |
Firefox Mobile |
IE Mobile |
Opera Mobile |
Safari Mobile |
|---|---|---|---|---|---|---|
| 基本 | ◯ | ◯ | ◯ | ◯ | ◯ | ◯ |
関連項目
© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
- 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
- MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。