Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Array.prototype.copyWithin: kopiowanie zakresu w tej samej tablicy

copyWithin kopiuje elementy wewnątrz tego samego odbiorcy, zachowując długość i poprawnie obsługując nakładanie zakresów.

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

Składnia

array.copyWithin(target, start[, end])

array.copyWithin(target, start[, end]) mutuje odbiorcę i zwraca dokładnie ten sam obiekt. Kopiuje zakres [start, end) na pozycję target; indeksy ujemne liczą od końca, a ułamki są obcinane. Długość nigdy się nie zmienia.

Algorytm wybiera kierunek kopiowania jak memmove, więc nakładające się zakresy nie niszczą jeszcze nieodczytanych wartości. Jeśli źródłowa pozycja jest dziurą, docelowa właściwość zostaje usunięta. Metoda jest generyczna dla zapisywalnych obiektów array-like; read-only właściwość lub błąd proxy może zgłosić TypeError. Przykład kopiuje końcówkę na środek.

Przykłady

const values = [1, 2, 3, 4, 5];
const returned = values.copyWithin(1, 3);
console.log(values.join(","));
console.log(returned === values, values.length);

Wynik

1,4,5,4,5
true 5

Źródła