此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Array.prototype.fill()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.
fill() 方法用一个固定值填充一个数组中从起始索引（默认为0）到终止索引（默认为array.length）内的全部元素。它返回修改后的数组。
尝试一下
const array1 = [1, 2, 3, 4];// Fill with 0 from position 2 until position 4console.log(array1.fill(0, 2, 4));// Expected output: Array [1, 2, 0, 0]// Fill with 5 from position 1console.log(array1.fill(5, 1));// Expected output: Array [1, 5, 5, 5]console.log(array1.fill(6));// Expected output: Array [6, 6, 6, 6]语法
fill(value)fill(value, start)fill(value, start, end)参数
value用来填充数组元素的值。注意所有数组中的元素都将是这个确定的值：如果
value是个对象，那么数组的每一项都会引用这个元素。start可选基于零的索引，从此开始填充，转换为整数。
- 负数索引从数组的末端开始计算，如果
start < 0，则使用start + array.length。 - 如果
start < -array.length或start被省略，则使用0。 - 如果
start >= array.length，没有索引被填充。
- 负数索引从数组的末端开始计算，如果
end可选基于零的索引，在此结束填充，转换为整数。
fill()填充到但不包含end索引。- 负数索引从数组的末端开始计算，如果
end < 0，则使用end + array.length。 - 如果
end < -array.length，则使用0。 - 如果
end >= array.length或end被省略，则使用array.length，导致所有索引都被填充。 - 如果经标准化后，
end的位置在start之前或之上，没有索引被填充。
- 负数索引从数组的末端开始计算，如果
返回值
经value 填充修改后的数组。
描述
fill() 是个修改方法，不会改变this 的长度，但会改变this 的内容。
fill() 也会使用value 填充稀疏数组的空槽。
fill() 方法是通用的。它只期望this 值有一个length 属性。虽然字符串也是类似数组的，但这个方法不适合应用于它们，因为字符串是不可变的。
备注：在一个空数组（length = 0）上使用Array.prototype.fill() 不会对其进行修改，因为数组没有要修改的内容。要在声明一个数组时使用Array.prototype.fill()，请确保数组的length 不为零。参见示例。
示例
使用 fill
console.log([1, 2, 3].fill(4)); // [4, 4, 4]console.log([1, 2, 3].fill(4, 1)); // [1, 4, 4]console.log([1, 2, 3].fill(4, 1, 2)); // [1, 4, 3]console.log([1, 2, 3].fill(4, 1, 1)); // [1, 2, 3]console.log([1, 2, 3].fill(4, 3, 3)); // [1, 2, 3]console.log([1, 2, 3].fill(4, -3, -2)); // [4, 2, 3]console.log([1, 2, 3].fill(4, NaN, NaN)); // [1, 2, 3]console.log([1, 2, 3].fill(4, 3, 5)); // [1, 2, 3]console.log(Array(3).fill(4)); // [4, 4, 4]// 一个简单的对象，被数组的每个空槽所引用const arr = Array(3).fill({}); // [{}, {}, {}]arr[0].hi = "hi"; // [{ hi: "hi" }, { hi: "hi" }, { hi: "hi" }]使用 fill() 创建全 1 矩阵
此示例演示了如何创建全 1 的矩阵，就像 Octave 或 MATLAB 的ones() 函数做到的那样。
const arr = new Array(3);for (let i = 0; i < arr.length; i++) { arr[i] = new Array(4).fill(1); // 创建一个大小为 4 的数组，填充全 1}arr[0][0] = 10;console.log(arr[0][0]); // 10console.log(arr[1][0]); // 1console.log(arr[2][0]); // 1使用 fill() 填充空数组
此示例演示了如何填充数组，将所有值设定为一个特定的值。无需指定end 参数。
const tempGirls = Array(5).fill("girl", 0);注意，数组最初为稀疏数组，没有分配索引。fill() 仍然可以填充这个数组。
在非数组对象上调用 fill()
fill() 方法读取this 的length 属性，并设置从start 到end 的每个整数属性的值。
const arrayLike = { length: 2 };console.log(Array.prototype.fill.call(arrayLike, 1));// { '0': 1, '1': 1, length: 2 }规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.fill |