O método JavaScript Array fill () retorna uma matriz preenchendo todos os elementos com um valor estático.
A sintaxe do fill()
método é:
arr.fill(value, start, end)
Aqui, arr é um array.
Parâmetros fill ()
O fill()
método inclui:
- valor - valor com o qual preencher a matriz.
- start (opcional) - Índice inicial (o padrão é 0 ).
- end (opcional) - Índice final (o padrão é Array.length ) (exclusivo).
Valor de retorno de fill ()
- Retorna a matriz modificada, preenchida com o valor do início ao fim.
Notas:
- Se o início ou o fim forem negativos, os índices serão contados de trás para frente.
- Como
fill()
é um método modificador, ele muda o próprio array (não uma cópia) e o retorna.
Exemplo: Preenchendo matriz com método fill ()
var prices = (651, 41, 4, 3, 6); // if only one argument, fills all elements new_prices = prices.fill(5); console.log(prices); // ( 5, 5, 5, 5, 5 ) console.log(new_prices); // ( 5, 5, 5, 5, 5 ) // start and end arguments specify what range to fill prices.fill(10, 1, 3); console.log(prices); // ( 5, 10, 10, 5, 5 ) // -ve start and end to count from back prices.fill(15, -2); console.log(prices); // ( 5, 10, 10, 15, 15 ) // invalid indexed result in no change prices.fill(15, 7, 8); console.log(prices); // ( 5, 10, 10, 15, 15 ) prices.fill(15, NaN, NaN); console.log(prices); // ( 5, 10, 10, 15, 15 )
Resultado
(5, 5, 5, 5, 5) (5, 5, 5, 5, 5) (5, 10, 10, 5, 5) (5, 10, 10, 15, 15) (5, 10, 10 , 15, 15) (5, 10, 10, 15, 15)
Aqui, podemos ver que o fill()
método preenche a matriz do início ao fim com o valor passado. O fill()
método altera a matriz no local e também retorna a matriz modificada.
Os parâmetros de início e fim são opcionais e também podem ser negativos (para contagem regressiva).
A matriz não é atualizada se os argumentos inicial e final forem inválidos.
Leitura Recomendada: Array JavaScript