Сводка

Методpush() добавляет один или более элементов в конец массива и возвращает новую длину массива.

Синтаксис

arr.push(element1, ..., elementN)

Параметры

elementN

Элементы, добавляемые в конец массива.

Возвращаемое значение

Новое значение свойстваlength объекта, для которого был вызван данный метод.

Описание

Методpush присоединяет значения к массиву.

Методpush не является привязанным к типу; этот метод может бытьвызван илиприменён к объектам, напоминающим массив. Метод опирается на свойствоlength для определения места вставки значений. Если свойствоlength не может быть преобразовано в число, будет использовать индекс 0. Сюда входит случай несуществования свойстваlength, в этом случае оно также будет создано.

Единственными родными массивоподобными объектами являютсястроки, хотя к ним он не может быть применён, поскольку строки являются неизменяемыми.

Примеры

Пример: добавление элементов в массив

Следующий код создаёт массивsports, содержащий два элемента, а затем добавляет к нему ещё два элемента. Переменнаяtotal будет содержать новую длину массива.

var sports = ["футбол", "бейсбол"];var total = sports.push("американский футбол", "плавание");console.log(sports); // ['футбол', 'бейсбол', 'американский футбол', 'плавание']console.log(total); // 4

Пример: слияние двух массивов

В этом примере используется функцияapply() для помещения всех элементов из второго массива в первый.

var vegetables = ["пастернак", "картошка"];var moreVegs = ["сельдерей", "свёкла"];// Сливает второй массив с первым// Эквивалентно вызову vegetables.push('сельдерей', 'свёкла');Array.prototype.push.apply(vegetables, moreVegs);console.log(vegetables); // ['пастернак', 'картошка', 'сельдерей', 'свёкла']

Спецификации

Совместимость с браузерами

Смотрите также

• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.unshift()
• Array.prototype.concat()