← 返回首页
Array.prototype.unshift() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. 給開發者的 Web 技術文件
  2. JavaScript
  3. JavaScript 參考文件
  4. 標準內建物件
  5. Array
  6. Array.prototype.unshift()
Theme
  • OS default
  • Light
  • Dark
正體中文 (繁體)
Remember language Learn more

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

View in English Always switch to English

Array.prototype.unshift()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.

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

In this article

嘗試一下

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

語法

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

參數

elementN

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

回傳值

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

描述

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

unshift 被刻意設計為具通用性；此方法可以藉由 called 或 applied 應用於類似陣列的物件上。若欲應用此方法的物件不包含代表一系列啟始為零之數字屬性序列長度的 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® 2027 Language Specification
# sec-array.prototype.unshift

瀏覽器相容性

Enable JavaScript to view this browser compatibility table.

參見

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 2025年7月14日 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. 標準內建物件
  2. Array
  3. 建構子
    1. Array()
  4. 靜態方法
    1. Array.from()
    2. fromAsync()
    3. Array.isArray()
    4. Array.of()
  5. 靜態屬性
    1. [Symbol.species]
  6. 實體方法
    1. at()
    2. Array.prototype.concat()
    3. Array.prototype.copyWithin()
    4. Array.prototype.entries()
    5. every()
    6. Array.prototype.fill()
    7. Array.prototype.filter()
    8. Array.prototype.find()
    9. Array.prototype.findIndex()
    10. findLast()
    11. findLastIndex()
    12. Array.prototype.flat()
    13. flatMap()
    14. forEach()
    15. Array.prototype.includes()
    16. Array.prototype.indexOf()
    17. Array.prototype.join()
    18. Array.prototype.keys()
    19. Array.prototype.lastIndexOf()
    20. Array.prototype.map()
    21. Array.prototype.pop()
    22. Array.prototype.push()
    23. Array.prototype.reduce()
    24. reduceRight()
    25. Array.prototype.reverse()
    26. Array.prototype.shift()
    27. Array.prototype.slice()
    28. some()
    29. Array.prototype.sort()
    30. Array.prototype.splice()
    31. toLocaleString()
    32. toReversed()
    33. toSorted()
    34. toSpliced()
    35. Array.prototype.toString()
    36. Array.prototype.unshift()
    37. Array.prototype.values()
    38. with()
    39. Array.prototype[Symbol.iterator]()
  7. 實體屬性
    1. Array.length
    2. [Symbol.unscopables]
  8. 繼承
  9. Object/Function
  10. 靜態方法
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call
    4. toString()
    5. [Symbol.hasInstance]()
  11. 靜態屬性
    1. displayName
    2. Function.length
    3. name
    4. prototype
    5. arguments
    6. caller
  12. 實體方法
    1. __defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. isPrototypeOf()
    7. propertyIsEnumerable()
    8. toLocaleString()
    9. toString()
    10. valueOf()
  13. 實體屬性
    1. __proto__
    2. constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.