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.
endOptional- 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
