База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.push: добавяне в края

push добавя произволен брой стойности от текущата дължина и връща новата дължина на получателя.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.push(...items)

array.push(...items) прочита length, записва последователните елементи от този индекс, задава новата length и я връща като число. Аргументите се съхраняват без сплескване; извикване без аргументи пак връща текущата дължина. Методът променя получателя и е общ за изменяеми array-like обекти.

Получател null или undefined хвърля TypeError. Ако дължината плюс броят аргументи надвиши максималната безопасна дължина 2^53 - 1, алгоритъмът хвърля TypeError. Истински Array има и ограничение 2^32 - 1. Индекс без право за запис, length само за четене или Proxy капан може да хвърли грешка, а предишните записи не е задължително да се отменят. Примерът показва масив, array-like обект и неразширяем масив.

Примери

const values = ["a"];
console.log(values.push("b", "c"), values.join(","));
const record = { 0: "x", length: 1 };
console.log(Array.prototype.push.call(record, "y", "z"), record.length, record[1] + record[2]);
const fixed = Object.preventExtensions(["x"]);
try { fixed.push("y"); } catch (error) {
  console.log(error.name, fixed.length);
}

Резултат

3 a,b,c
3 3 yz
TypeError 1

Източници