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