Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.push: dopisywanie na końcu

push dopisuje dowolną liczbę wartości od bieżącej długości i zwraca nową długość odbiorcy.

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

Składnia

array.push(...items)

array.push(...items) odczytuje length, zapisuje kolejne elementy od tego indeksu, ustawia nową length i zwraca ją jako liczbę. Argumenty są zapisywane bez spłaszczania; wywołanie bez argumentów nadal zwraca bieżącą długość. Metoda mutuje odbiorcę i jest generyczna dla modyfikowalnych obiektów array-like.

Odbiorca null lub undefined powoduje TypeError. Jeśli długość z liczbą argumentów przekroczyłaby maksymalną bezpieczną długość 2^53 - 1, algorytm zgłasza TypeError. Dla prawdziwej tablicy obowiązuje dodatkowo limit długości 2^32 - 1. Niemodyfikowalny indeks, tylko do odczytu length lub pułapka Proxy może zgłosić wyjątek, a wcześniejsze zapisy nie muszą zostać cofnięte. Przykład pokazuje tablicę, obiekt array-like i błąd na nierozszerzalnej tablicy.

Przykłady

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

Wynik

3 a,b,c
3 3 yz
TypeError 1

Źródła