push()方法添加一个或多个元素到数组的末尾,并返回数组新的长度(length属性值)。
语法
arr.push(element1,....,elementN)
参数
N:被添加到数组末尾的元素。
返回值
当调用该方法时,新的length属性值将被返回。
描述
push方法把值添加到数组中。
push方法有意具有通用性。该方法和call()或apply()一起使用时,可应用在类似数组的对象上。push方法根据length属性来决定从哪里开始插入给定的值。如果length不能被转换成一个数值,则插入的元素索引为0,包括length不存在时。当length不存在时,将会创建它。
唯一的原生类数组(array-like)对象是 Strings
,尽管如此,它们并不适用该方法,因为字符串是不可改变的。
示例
例子1:
添加元素到数组
下面的代码创建了 sports
数组,包含两个元素,然后又把两个元素添加给它。total
变量为数组的新长度值。
var sports = ["soccer", "baseball"];
var total = sports.push("football", "swimming");
console.log(sports); // ["soccer", "baseball", "football", "swimming"]
console.log(total); // 4
例子2:合并两个数组
该示例使用 apply()
添加第二个数组的所有元素。
var vegetables = ['parsnip', 'potato'];
var moreVegs = ['celery', 'beetroot'];
// Merge the second array into the first one
// Equivalent to vegetables.push('celery', 'beetroot');
Array.prototype.push.apply(vegetables, moreVegs);
console.log(vegetables); // ['parsnip', 'potato', 'celery', 'beetroot']