Array.unshift() 开头添加元素
最后更新：2026-09-09
Array.unshift() 开头添加元素
unshift 把一个或多个元素插入数组开头，返回新长度。与 shift 组成队列操作。注意 unshift 也是 O(n)——每个已有元素都要后移。
| 分类 | 数组 |
|---|---|
| ES 版本 | ES1（1997） |
📝 语法
const 新长度 = 数组.unshift(元素1, ..., 元素N);⚙️ 参数
| elementN | 要插入开头的一个或多个元素，按参数顺序排在最前。 |
|---|
返回值：插入后的数组长度。
是否修改原值：是（原地修改）
▶ 示例
编辑下方代码，点击运行，在输出面板查看结果：
运行结果：
3
最新消息A
新消息⚠️ 警告 unshift 与 shift 一样是 O(n)——所有已有元素要后移。高性能场景用双端队列结构。
💡 提示 unshift(...arr2) 可以把另一个数组的元素整体插到开头（注意展开符）。
🌐 浏览器支持
| 浏览器 |  Chrome |
 Edge |
 Firefox |
 Safari |
 Opera |
|---|---|---|---|---|---|
| Array.unshift() | ✓ v1 | ✓ v12 | ✓ v1.5 | ✓ v3 | ✓ v10.5 |
| 所有现代浏览器均支持 | |||||
🏷️ 相关数组方法
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Qunshift 和 push 的区别？
Aunshift 插入开头（O(n)），push 追加末尾（O(1)）。无特殊顺序要求时优先 push。
Qunshift 返回什么？
A新长度（数字），与 push 一致。
Q想在开头插入另一个数组的元素怎么办？
Aarr.unshift(...arr2) 用展开符逐个插入；直接 unshift(arr2) 会把整个数组作为一个元素。
