Skip to content
Navigation Menu
Sign in
Appearance settings
Platform
AI CODE CREATION
GitHub Copilot
Write better code with AI
GitHub Copilot app
Direct agents from issue to merge
MCP Registry
Integrate external tools
DEVELOPER WORKFLOWS
Actions
Automate any workflow
Codespaces
Instant dev environments
Issues
Plan and track work
Code Review
Manage code changes
Code Quality
Enforce quality at merge
APPLICATION SECURITY
GitHub Advanced Security
Find and fix vulnerabilities
Code security
Secure your code as you build
Secret protection
Stop leaks before they start
EXPLORE
Why GitHub
Documentation
Blog
Changelog
Marketplace
View all features
Solutions
BY COMPANY SIZE
Enterprises
Small and medium teams
Startups
Nonprofits
BY USE CASE
App Modernization
DevSecOps
DevOps
CI/CD
View all use cases
BY INDUSTRY
Healthcare
Financial services
Manufacturing
Government
View all industries
View all solutions
Resources
EXPLORE BY TOPIC
AI
Software Development
DevOps
Security
View all topics
EXPLORE BY TYPE
Customer stories
Events & webinars
Ebooks & reports
Business insights
GitHub Skills
SUPPORT & SERVICES
Documentation
Customer support
Community forum
Trust center
Partners
View all resources
Open Source
COMMUNITY
GitHub Sponsors
Fund open source developers
PROGRAMS
Security Lab
Maintainer Community
GitHub Stars
Archive Program
REPOSITORIES
Topics
Trending
Collections
Enterprise
ENTERPRISE SOLUTIONS
Enterprise platform
AI-powered developer platform
AVAILABLE ADD-ONS
GitHub Advanced Security
Enterprise-grade security features
Copilot for Business
Enterprise-grade AI features
Premium Support
Enterprise-grade 24/7 support
Pricing
Search
/
Sign in
Sign up
Appearance settings
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
{{ message }}
mdn
translated-content
Repository navigation
Code
Issues
176
(176)
Pull requests
253
(253)
Actions
Projects
Security and quality
Insights
More
items
Files
Expand file tree
main
Breadcrumbs
translated-content
/
files
/
zh-tw
/
web
/
javascript
/
reference
/
global_objects
/
array
/
unshift
/
index.md
Copy path
Blame
More file actions
Blame
More file actions
Latest commit
History
History
History
69 lines (44 loc) · 1.59 KB
main
Breadcrumbs
translated-content
/
files
/
zh-tw
/
web
/
javascript
/
reference
/
global_objects
/
array
/
unshift
/
index.md
Copy path
Top
File metadata and controls
Preview
Code
Blame
69 lines (44 loc) · 1.59 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
---
title
:
Array.prototype.unshift()
slug
:
Web/JavaScript/Reference/Global_Objects/Array/unshift
---
**
`
unshift()
`
**
方法會添加一個或多個元素至陣列的開頭,並且回傳陣列的新長度。
{{InteractiveExample("JavaScript Demo: Array.unshift()")}}
```
js
interactive-example
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]
```
##
語法
```
plain
arr.unshift(element1[, ...[, elementN]])
```
###
參數
-
`
elementN
`
-
: 欲添加至陣列開頭的元素。
###
回傳值
呼叫此方法之物件的新 {{jsxref("Array.length", "length")}} 屬性值。
##
描述
`
unshift
`
方法會將一或多個給定值插入至一個類陣列(array-like)物件的開頭。
`
unshift
`
被刻意設計為具通用性;此方法可以藉由 {{jsxref("Function.call", "called", "", 1)}} 或 {{jsxref("Function.apply", "applied", "", 1)}} 應用於類似陣列的物件上。若欲應用此方法的物件不包含代表一系列啟始為零之數字屬性序列長度的
`
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]
```
##
規範
{{Specifications}}
##
瀏覽器相容性
{{Compat}}
##
參見
-
{{jsxref("Array.prototype.push()")}}
-
{{jsxref("Array.prototype.pop()")}}
-
{{jsxref("Array.prototype.shift()")}}
-
{{jsxref("Array.prototype.concat()")}}
You can’t perform that action at this time.