push

撰写时间：2024-03-11

最新修订：2024-03-11

push

将可变长的元素添加至数组末尾。改变原数组。

原型

numberpush

... *elements

参数

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

返回值

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

说明

push方法将可变长的元素添加至数组的末尾。

JavaScript的数组是以栈的形式来实现的。数组首个元素位于栈底，最后一个元素位于栈顶。因此每添加一个元素，就是将该元素压入栈中。这是该方法名称push的由来。

与之相对应，pop方法将最后一个元素弹出栈。

而与此方法类似的unshift方法则将可变长的元素添加至数组的首部。

例子

添加单个元素

let arr = [5, 7, 9]; let result = arr.push(3); console.log(arr); // [5, 7, 9, 3] console.log(result); // 4

push方法将数值3压入栈中而成为最后一个元素。返回数组的最后长度。

添加多个元素

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

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

添加不同类型的多个元素

可同时添加不同类型的多个元素。

let arr = [5, 7, 9]; let result = arr.push([1, 2, 3], 'a', {width: 15}); console.log(arr); // [5, 7, 9, [1, 2, 3], "a", {width: 15}] console.log(result); // 6

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

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

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

参见

参考资源

ECMA 262: Array Objects