Movatterモバイル変換


[0]ホーム

URL:


MDN Web Docs

此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

Array.prototype.unshift()

BaselineWidely available

unshift() 方法會添加一個或多個元素至陣列的開頭,並且回傳陣列的新長度。

嘗試一下

const array1 = [1, 2, 3];console.log(array1.unshift(4, 5));// Expected output: 5console.log(array1);// Expected output: Array [4, 5, 1, 2, 3]

語法

arr.unshift(element1[, ...[, elementN]])

參數

elementN

欲添加至陣列開頭的元素。

回傳值

呼叫此方法之物件的新length 屬性值。

描述

unshift 方法會將一或多個給定值插入至一個類陣列(array-like)物件的開頭。

unshift 被刻意設計為具通用性;此方法可以藉由calledapplied 應用於類似陣列的物件上。若欲應用此方法的物件不包含代表一系列啟始為零之數字屬性序列長度的length 屬性,可能是不具任何意義的行為。

範例

js
var arr = [1, 2];arr.unshift(0); // 執行後的結果是3,其代表處理後的陣列長度// arr is [0, 1, 2]arr.unshift(-2, -1); // = 5// arr is [-2, -1, 0, 1, 2]arr.unshift([-3]);// arr is [[-3], -2, -1, 0, 1, 2]

規範

Specification
ECMAScript® 2026 Language Specification
# sec-array.prototype.unshift

瀏覽器相容性

參見

Help improve MDN

Learn how to contribute.

This page was last modified on byMDN contributors.


[8]ページ先頭

©2009-2025 Movatter.jp