Método copyWithin() do Array JavaScript

Definição e uso

copyWithin() O método copia elementos do array para outra posição no array, cobrindo os valores existentes.

copyWithin() O método nunca adiciona mais itens ao array.

Dica:copyWithin() O método cobre o array original.

Exemplo

Exemplo 1

Copie os dois primeiros elementos do array para os dois últimos elementos do array:

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.copyWithin(2, 0);

Experimente você mesmo

Exemplo 2

Copie os dois primeiros elementos do array para as terceiras e quartas posições:

var fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi", "Papaya"];
fruits.copyWithin(2, 0, 2);

Experimente você mesmo

Sintaxe

array.copyWithin(target, start, end)

Valor do parâmetro

Parâmetro Descrição
target Obrigatório. O índice de destino para a cópia do elemento.
start Opcional. O índice de início da cópia do elemento (padrão é 0).
end Opcional. O índice de parada para a cópia do elemento (padrão é array.length).

Detalhes técnicos

Retorno: Array, array modificado.
Versão do JavaScript: ECMAScript 6

Suporte do navegador

Os números na tabela indicam a primeira versão do navegador que suporta plenamente o método.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge Firefox 32 Safari 9 Opera 32
Setembro de 2015 Julho de 2015 Setembro de 2014 Setembro de 2015 Setembro de 2015

Observação:O Internet Explorer não suporta o método copyWithin().

Páginas relacionadas

Tutorial:Array do JavaScript

Tutorial:Const do array do JavaScript

Tutorial:Métodos de array do JavaScript

Tutorial:Arranjo de array do JavaScript

Tutorial:Iteração de array do JavaScript