Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.copyWithin: cópia de intervalo no mesmo array

copyWithin copia elementos dentro do mesmo recetor, conserva o comprimento e trata corretamente intervalos sobrepostos.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

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

array.copyWithin(target, start[, end]) altera o recetor e devolve esse mesmo objeto. Copia [start, end) para target; índices negativos contam do fim e frações são truncadas. O comprimento não muda.

Como memmove, o algoritmo escolhe a direção para proteger valores ainda necessários em sobreposição. Uma posição vazia na origem elimina a propriedade alvo. É genérico para objetos array-like graváveis; propriedades só de leitura ou erros de proxy podem lançar TypeError. O exemplo copia o fim para o meio.

Exemplos

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

Fontes