Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.push: přidávání na konec

push přidá libovolný počet hodnot od aktuální délky a vrátí novou délku příjemce.

Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.push(...items)

array.push(...items) přečte length, zapíše po sobě jdoucí položky od tohoto indexu, nastaví novou length a vrátí ji jako číslo. Argumenty se ukládají bez zploštění; volání bez argumentů stále vrátí aktuální délku. Metoda mění příjemce a je obecná pro měnitelné array-like objekty.

Příjemce null nebo undefined vyvolá TypeError. Pokud by délka s počtem argumentů překročila maximální bezpečnou délku 2^53 - 1, algoritmus vyvolá TypeError. Skutečný Array má navíc limit 2^32 - 1. Nezapisovatelný index, length jen pro čtení nebo past Proxy může vyvolat chybu a dřívější zápisy se nemusejí vrátit zpět. Příklad ukazuje pole, array-like objekt a nerozšiřitelné pole.

Příklady

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);
}

Výsledek

3 a,b,c
3 3 yz
TypeError 1

Zdroje