Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.toSpliced: zmieniona kopia bez mutacji

toSpliced zwraca nową tablicę po usunięciu i wstawieniu wskazanych pozycji, nie zmieniając odbiorcy.

Wersja: ECMAScript 2023; example target: Node.js 24.22.2

Składnia

array.toSpliced(start, skipCount?, ...items)

array.toSpliced(start, skipCount?, ...items) jest kopiującym odpowiednikiem splice(): tworzy zwykłą nową tablicę, pomija wybrany fragment i wstawia items, a array pozostawia bez zmian. Ujemny start liczy od końca; pozycja poza długością oznacza koniec. Pominięty skipCount przy podanym start usuwa ogon, jawne undefined oznacza zero, a pozostałe wartości są ograniczane do dostępnego zakresu.

Wynikiem jest cała zmieniona kopia, a nie tablica usuniętych elementów. Kopia jest płytka, zawsze gęsta i nie używa Symbol.species: dziury odbiorcy stają się własnościami o wartości undefined. Wywołanie bez argumentów daje gęstą kopię.

Metoda pochodzi z ECMAScript 2023 i jest generyczna dla array-like. null lub undefined jako odbiorca powoduje TypeError; zbyt duża obliczona długość powoduje TypeError albo RangeError, a błędy konwersji, getterów i proxy trapów są propagowane.

Przykłady

const source = ["build", "test", "deploy"];
const changed = source.toSpliced(1, 1, "lint", "test");
console.log(changed.join(","));
console.log(source.join(","));
console.log(source.toSpliced(-1).join(","));
console.log(source.toSpliced(1, undefined, "docs").join(","));

const dense = [1, , 3].toSpliced(1, 0, 2);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, 3 in dense);
console.log(dense[0], dense[1], String(dense[2]), dense[3]);

Wynik

build,lint,test,deploy
build,test,deploy
build,test
build,docs,test,deploy
4 true true true true
1 2 undefined 3

Źródła