CKTIS / JavaScript
Array.prototype.copyWithin: bereik binnen dezelfde array kopiëren
copyWithin kopieert elementen binnen dezelfde ontvanger, behoudt de lengte en verwerkt overlappende bereiken veilig.
Versie: ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntax
array.copyWithin(target, start[, end])array.copyWithin(target, start[, end]) muteert de ontvanger en retourneert exact dat object. Het kopieert [start, end) naar target; negatieve indexen tellen vanaf het einde en breuken worden afgekapt. De lengte wijzigt niet.
Zoals memmove kiest het algoritme de richting zodat overlap nog benodigde waarden niet vernietigt. Een gat in de bron verwijdert de doeleigenschap. Het is generiek voor schrijfbare array-achtige objecten; een alleen-lezen eigenschap of proxyfout kan TypeError werpen. Het voorbeeld kopieert de staart naar het midden.
Voorbeelden
const values = [1, 2, 3, 4, 5];
const returned = values.copyWithin(1, 3);
console.log(values.join(","));
console.log(returned === values, values.length);Resultaat
1,4,5,4,5 true 5