Array.prototype.fill()

Probieren Sie es aus

const array = [1, 2, 3, 4];

// Fill with 0 from position 2 until position 4
console.log(array.fill(0, 2, 4));
// Expected output: Array [1, 2, 0, 0]

// Fill with 5 from position 1
console.log(array.fill(5, 1));
// Expected output: Array [1, 5, 5, 5]

console.log(array.fill(6));
// Expected output: Array [6, 6, 6, 6]

Syntax

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

Parameter

value

Wert, mit dem das Array gefllt werden soll. Beachten Sie, dass alle Elemente im Array genau diesen Wert haben werden: wenn value ein Objekt ist, wird jeder Platz im Array auf dieses Objekt verweisen.

start Optional

Der nullbasierte Index, an dem das Fllen beginnt, konvertiert in eine Ganzzahl.

• Ein negativer Index zhlt vom Ende des Arrays zurck wenn -array.length <= start < 0, wird start + array.length verwendet.
• Wenn start < -array.length oder start weggelassen wird, wird 0 verwendet.
• Wenn start >= array.length, wird kein Index gefllt.

end Optional

Der nullbasierte Index, an dem das Fllen endet, konvertiert in eine Ganzzahl. fill() fllt bis, aber nicht einschlielich end.

• Ein negativer Index zhlt vom Ende des Arrays zurck wenn -array.length <= end < 0, wird end + array.length verwendet.
• Wenn end < -array.length, wird 0 verwendet.
• Wenn end >= array.length oder end weggelassen oder undefined ist, wird array.length verwendet, wodurch alle Indizes bis zum Ende gefllt werden.
• Wenn end eine Position vor oder an der Position angibt, die start angibt, wird nichts gefllt.

Rckgabewert

Das modifizierte Array, gefllt mit value.

Beschreibung

Die fill() Methode ist eine mutierende Methode. Sie verndert nicht die Lnge von this, aber sie wird den Inhalt von this ndern.

Die fill() Methode fllt auch leere Stellen in sparse Arrays mit value.

Die fill() Methode ist generisch. Sie erwartet nur, dass der this Wert eine length Eigenschaft hat. Obwohl Strings auch array-hnlich sind, ist diese Methode nicht geeignet, um auf ihnen angewendet zu werden, da Strings unvernderlich sind.

Beispiele

Verwendung von 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]

// A single object, referenced by each slot of the array:
const arr = Array(3).fill({}); // [{}, {}, {}]
arr[0].hi = "hi"; // [{ hi: "hi" }, { hi: "hi" }, { hi: "hi" }]

Verwendung von fill(), um eine Matrix aus Einsen zu erstellen

Dieses Beispiel zeigt, wie man eine Matrix aus Einsen erstellt, hnlich der ones() Funktion von Octave oder MATLAB.

const arr = new Array(3);
for (let i = 0; i < arr.length; i++) {
  arr[i] = new Array(4).fill(1); // Creating an array of size 4 and filled of 1
}
arr[0][0] = 10;
console.log(arr[0][0]); // 10
console.log(arr[1][0]); // 1
console.log(arr[2][0]); // 1

Verwendung von fill(), um ein leeres Array zu fllen

Dieses Beispiel zeigt, wie man ein Array fllt, indem alle Elemente auf einen bestimmten Wert gesetzt werden. Der end Parameter muss nicht angegeben werden.

const tempGirls = Array(5).fill("girl", 0);

Beachten Sie, dass das Array ursprnglich ein sparse array ohne zugewiesene Indizes war. fill() ist dennoch in der Lage, dieses Array zu fllen.

Aufrufen von fill() auf Nicht-Array-Objekten

Die fill() Methode liest die length Eigenschaft von this und setzt den Wert jeder ganzzahligen Schlssel-Eigenschaft von start bis end.

const arrayLike = { length: 2 };
console.log(Array.prototype.fill.call(arrayLike, 1));
// { '0': 1, '1': 1, length: 2 }

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Array.prototype.fill in core-js
• Leitfaden zu indizierten Sammlungen
• Array
• TypedArray.prototype.fill()