Array.unshift() 先頭に要素を追加
最終更新:2026-10-13
Array.unshift() 先頭に要素を追加
unshift は1つ以上の要素を配列の先頭に挿入し、新しい長さを返します。shift と組み合わせてキュー操作を実現します。
| カテゴリ | 配列 |
|---|
⚙️ 引数
| elementN |
|---|
戻り値:挿入後の配列の長さ。
元の値を変更するか:はい(その場で変更)
▶ 例
コードを編集して「実行」を押すと、出力パネルに結果が表示されます。
実行結果:
3
new msgA
newer
⚠️ 警告
💡 ヒント
🌐 ブラウザ対応
| ブラウザ | |||||
|---|---|---|---|---|---|
| Array.unshift() | ✓ v1 | ✓ v12 | ✓ v1.5 | ✓ v3 | ✓ v10.5 |
| すべてのモダンブラウザで対応 | |||||
🏷️ 関連する配列メソッド
💡 関連するケース
さらに多くのケースは近日公開予定です。
📚 関連チュートリアル
❓ よくある質問
Qunshift と push の違いは?
Aunshift は先頭に追加(O(n))、push は末尾に追加(O(1))します。順序が重要でなければ push を使います。
Qunshift は何を返しますか?
Apush と同様、新しい長さを返します。
Q配列の要素を先頭に追加するには?
Aarr.unshift(...arr2) で展開します。unshift(arr2) は配列全体を1つの要素として入れ子にします。