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