目录

JavaScript Array copyWithin()

Examples

Copy the first two array elements to the last two array elements:

const fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.copyWithin(2, 0);
Try it Yourself »

Copy the first two array elements to the third and fourth position:

const fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi"];
fruits.copyWithin(2, 0, 2);
Try it Yourself »

Description

The copyWithin() method copies array elements to another position in the array.

The copyWithin() method overwrites the existing values.

The copyWithin() method does not add items to the array.


Syntax

array.copyWithin( target, start, end)

Parameters

Parameter Description
target Required.
The index (position) to copy the elements to.
start Optional.
The start index (position). Default is 0.
end Optional.
The end index (position). Default is the array length.

Return Value

Type Description
Array The changed array.


Browser Support

copyWithin() is an ECMAScript6 (ES6) feature.

ES6 (JavaScript 2015) is supported in all modern browsers:

Chrome Edge Firefox Safari Opera
Yes Yes Yes Yes Yes

copyWithin() is not supported in Internet Explorer 11 (or earlier).