WebGL Tutorial
and more

unshift

撰写时间:2024-03-11

最新修订:2024-03-11

unshift

将可变长的元素添加至数组首部。改变原数组。

原型

numberunshift
  • ... *elements

参数

...elements
要添加的可变长的元素。

返回值

返回数组在添加元素完毕后的长度,也即数组的length属性值。

说明

unshift方法将可变长的元素添加至数组的首部。

shift方法将数组的首个元素移出数组。而与之相对应,unshift方法将元素添加至数组的首部。不同的是,shift只移除1个元素,而unshift可添加可变长的多个元素。

而与此方法类似的push方法则将可变长的元素添加至数组的末尾。

例子

基本用法

参数...elements是可变长的,因此可同时添加多个元素。

let arr = [5, 7, 9]; let result = arr.unshift(1, 2, 3); console.log(arr); // [1, 2, 3, 5, 7, 9] console.log(result); // 6

同时将1, 2, 3共3个元素添加到arr的首部。unshfit方法返回数组添加元素完毕后的长度。

使用...展开操作符添加元素

let arr = [5, 7, 9]; let itemsToPrepend = [1, 2, 3]; arr.unshift(...itemsToPrepend); console.log(arr); // [1, 2, 3, 5, 7, 9]

由于参数...elements是可变长的,因此可直接通过展开操作符...将另一个数组展开后再依序添加进来。

参见

  1. push
  2. shift

参考资源

  1. ECMA 262: Array Objects