The copyWithin()
method copies the sequence of array elements within the array to the position starting at target
. The copy is taken from the index positions of the second and third arguments start
and end
. The end
argument is optional and defaults to the length of the array. This method has the same algorithm as Array.prototype.copyWithin
. TypedArray is one of the typed array types here.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
typedarray.copyWithin(target, start[, end = this.length])
Parameters
target
- Target start index position where to copy the elements to.
start
- Source start index position where to start copying elements from.
end
Optional- Optional. Source end index position where to end copying elements from.
Return value
The modified array.
Description
See Array.prototype.copyWithin
for more details.
Examples
Using copyWithin
var buffer = new ArrayBuffer(8); var uint8 = new Uint8Array(buffer); uint8.set([1,2,3]); console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ] uint8.copyWithin(3,0,3); console.log(uint8); // Uint8Array [ 1, 2, 3, 1, 2, 3, 0, 0 ]
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'TypedArray.prototype.copyWithin' in that specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
copyWithin | Chrome Full support 45 | Edge Full support 14 | Firefox Full support 34 | IE No support No | Opera Full support 36 | Safari Full support 9.1 | WebView Android No support No | Chrome Android No support No | Firefox Android Full support 34 | Opera Android No support No | Safari iOS Full support 9.3 | Samsung Internet Android No support No | nodejs Full support 4.0.0 |
Legend
- Full support
- Full support
- No support
- No support