Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources