TypedArray.prototype.fill()

fill() メソッドは、型付き配列の開始位置から終了位置までのすべての要素を固定値で埋めます。このメソッドのアルゴリズムは Array.prototype.fill() と同じです。ここで TypedArray は、型付き配列型のうちの 1 つです。

試してみましょう

構文

fill(value)
fill(value, start)
fill(value, start, end)

引数

value

型付き配列を埋める値です。

start 省略可

開始位置です。既定値は 0 です。

end 省略可

終了位置(の次の位置)です既定値は this.length です。

返値

変更された配列です。

解説

埋める区間は [start, end) です。

fill() メソッドは value, start, end の 3 つまでの引数を取ります。 startend の各引数は省略可能で、既定値はそれぞれ 0 と、 this オブジェクトの length です。

start が負の数であった場合は、 length+start (length は配列の長さ) として扱われます。 end が負の数であった場合は、 length+end として扱われます。

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]

仕様書

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.fill

ブラウザーの互換性

BCD tables only load in the browser

関連情報