Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Array.prototype.copyWithin: copia de un rango en el mismo array

copyWithin copia elementos dentro del mismo receptor, conserva la longitud y maneja con seguridad rangos solapados.

Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxis

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

array.copyWithin(target, start[, end]) muta el receptor y devuelve ese mismo objeto. Copia [start, end) en target; los índices negativos cuentan desde el final y las fracciones se truncan. La longitud no cambia.

Como memmove, el algoritmo elige la dirección para que un solapamiento no destruya valores pendientes. Un hueco de origen elimina la propiedad destino. Es genérico para objetos array-like escribibles; una propiedad de solo lectura o un fallo de proxy puede lanzar TypeError. El ejemplo copia el final en el centro.

Ejemplos

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

Resultado

1,4,5,4,5
true 5

Fuentes