The fill()
method fills all the elements of a typed array from a start index to an end index with a static value. This method has the same algorithm as Array.prototype.fill()
. 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.fill(value[, start = 0[, end = this.length]])
Parameters
value
- Value to fill the typed array with.
start
- Optional. Start index. Defaults to 0.
end
- Optional. End index (not included). Defaults to this.length.
Return value
The modified array.
Description
The elements interval to fill is [start
, end
).
The fill
method takes up to three arguments value
, start
and end
. The start
and end
arguments are optional with default values of 0
and the length
of the this
object.
If start
is negative, it is treated as length+start
where length
is the length of the array. If end
is negative, it is treated as length+end
.
Polyfill
Since there is no global object with the name TypedArray, polyfilling must be done on an "as needed" basis. Use the following "polyfill" along with the Array.prototype.fill()
polyfill.
// https://tc39.github.io/ecma262/#sec-%typedarray%.prototype.fill if (!Uint8Array.prototype.fill) { Uint8Array.prototype.fill = Array.prototype.fill; }
Examples
Using fill
new Uint8Array([1, 2, 3]).fill(4); // Uint8Array [4, 4, 4] new Uint8Array([1, 2, 3]).fill(4, 1); // Uint8Array [1, 4, 4] new Uint8Array([1, 2, 3]).fill(4, 1, 2); // Uint8Array [1, 4, 3] new Uint8Array([1, 2, 3]).fill(4, 1, 1); // Uint8Array [1, 2, 3] new Uint8Array([1, 2, 3]).fill(4, -3, -2); // Uint8Array [4, 2, 3]
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'TypedArray.prototype.fill' in that specification. |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fill | Chrome Full support 45 | Edge Full support 14 | Firefox Full support 37 | IE No support No | Opera Full support 36 | Safari No support No | WebView Android No support No | Chrome Android Full support 45 | Firefox Android Full support 37 | Opera Android No support No | Safari iOS No support No | Samsung Internet Android Full support 5.0 | nodejs Full support 4.0.0 |
Legend
- Full support
- Full support
- No support
- No support