Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Array.prototype.fill: preencher um intervalo com um valor

fill altera um intervalo do recetor, escreve o mesmo valor em cada índice e devolve o recetor.

Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2

Sintaxe

array.fill(value[, start[, end]])

array.fill(value[, start[, end]]) escreve value no intervalo semiaberto [start, end) e devolve o mesmo objeto. Por omissão start é 0 e end o comprimento; índices negativos contam do fim, frações são truncadas e limites ajustados.

Preenche posições vazias criando propriedades. Um objeto não é clonado: cada índice recebe a mesma referência. É genérico para objetos array-like graváveis; array congelado, índice só de leitura ou proxy pode lançar TypeError após escritas parciais. Um intervalo vazio não altera nada. O exemplo mostra identidade partilhada e uma posição fora do intervalo.

Exemplos

const token = {kind: "shared"};
const values = new Array(3);
const returned = values.fill(token, 1);
console.log(0 in values);
console.log(values[1] === values[2]);
console.log(returned === values);

Resultado

false
true
true

Fontes