CKTIS / JavaScript
Array.prototype.copyWithin : copie d’une plage dans le même tableau
copyWithin copie des éléments dans le même receveur, conserve sa longueur et gère correctement les plages qui se chevauchent.
Version : ECMAScript 2026 draft; example target: Node.js 24.22.2
Syntaxe
array.copyWithin(target, start[, end])array.copyWithin(target, start[, end]) modifie le receveur et renvoie exactement cet objet. Il copie [start, end) vers target ; les indices négatifs partent de la fin et les fractions sont tronquées. La longueur ne change jamais.
Comme memmove, l’algorithme choisit le sens de copie pour protéger les valeurs lors d’un chevauchement. Un trou source supprime la propriété cible. La méthode est générique pour les objets array-like modifiables ; une propriété en lecture seule ou un proxy peut lever TypeError. L’exemple copie la fin au milieu.
Exemples
const values = [1, 2, 3, 4, 5];
const returned = values.copyWithin(1, 3);
console.log(values.join(","));
console.log(returned === values, values.length);Résultat
1,4,5,4,5 true 5