Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.splice: usuwanie, zastępowanie i wstawianie

splice mutuje tablicę w wybranym miejscu, przesuwa jej ogon i zwraca nową tablicę usuniętych elementów.

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

Składnia

array.splice(start, deleteCount?, ...items)

array.splice(start, deleteCount?, ...items) zmienia array w miejscu i zwraca nową tablicę z usuniętymi elementami. start jest konwertowany do liczby całkowitej: wartość ujemna liczy od końca, a pozycja poza długością oznacza koniec. Pominięty deleteCount przy podanym start usuwa cały ogon; jawne undefined oznacza zero. Inna wartość jest ograniczana do zakresu od zera do liczby pozostałych elementów. items są wstawiane przed przesuniętym ogonem.

Wynik ma długość równą liczbie usuniętych pozycji i zachowuje odpowiadające im dziury. Sama tablica może urosnąć, skurczyć się lub nie zmienić długości; splice() bez argumentów niczego nie usuwa. Utworzenie wyniku uwzględnia Symbol.species podklasy Array.

Metoda jest generyczna dla mutowalnych obiektów array-like: odczytuje length, kopiuje lub usuwa własności indeksowe i zapisuje nową długość. Może zgłosić TypeError, gdy zapis, usunięcie albo length są niedozwolone lub nowa długość przekroczyłaby 2^53 - 1; wyjątki z konwersji, getterów, setterów, proxy trapów i konstruktora species są propagowane.

Przykłady

const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));

const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));

const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));

const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));

Wynik

test
build,lint,test,deploy
test,deploy
build,lint
0 build,docs,lint
2 false true b c

Źródła