Array.prototype.toSpliced()

start

Der nullbasierte Index, an dem begonnen wird, das Array zu verändern, konvertiert zu einer Ganzzahl.

• Ein negativer Index zählt vom Ende des Arrays zurück — wenn -array.length <= start < 0, wird start + array.length verwendet.
• Wenn start < -array.length oder start ausgelassen wird, wird 0 verwendet.
• Wenn start >= array.length, wird kein Element gelöscht, aber die Methode verhält sich als Hinzufüge-Funktion und fügt so viele Elemente hinzu, wie angegeben sind.

skipCount Optional

Eine Ganzzahl, die die Anzahl der zu entfernenden (oder zu überspringenden) Elemente im Array ab start angibt.

Wenn skipCount ausgelassen wird oder sein Wert größer oder gleich der Anzahl der Elemente nach der durch start angegebenen Position ist, werden alle Elemente von start bis zum Ende des Arrays gelöscht. Wenn Sie jedoch irgendeinen itemN-Parameter angeben möchten, sollten Sie Infinity als skipCount übergeben, um alle Elemente nach start zu löschen, da ein explizites undefined in 0 konvertiert wird.

Wenn skipCount 0 oder negativ ist, werden keine Elemente entfernt. In diesem Fall sollten Sie mindestens ein neues Element angeben (siehe unten).

item1, …, itemN Optional

Die Elemente, die dem Array hinzugefügt werden sollen, beginnend bei start.

Wenn Sie keine Elemente angeben, wird toSpliced() nur Elemente aus dem Array entfernen.

Ein neues Array, das aus allen Elementen vor start, item1, item2, …, itemN und allen Elementen nach start + skipCount besteht.

Die toSpliced() Methode, ähnlich wie splice(), erledigt mehrere Aufgaben gleichzeitig: Sie entfernt die angegebene Anzahl von Elementen aus dem Array, beginnend bei einem bestimmten Index, und fügt anschließend die angegebenen Elemente an derselben Position ein. Sie gibt jedoch ein neues Array zurück, anstatt das ursprüngliche Array zu verändern. Die gelöschten Elemente werden daher nicht von dieser Methode zurückgegeben, bleiben jedoch im ursprünglichen Array zugänglich.

Die toSpliced() Methode erzeugt niemals ein dünn besetztes Array. Wenn das Quellarray dünn besetzt ist, werden die leeren Slots im neuen Array mit undefined ersetzt.

Die toSpliced() Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length Eigenschaft und ganzzahlige Schlüssel-Eigenschaften hat.

Sie können toSpliced() verwenden, um Elemente in einem Array zu löschen, hinzuzufügen und zu ersetzen und ein neues Array effizienter als mit slice() und concat() zu erstellen.

const months = ["Jan", "Mar", "Apr", "May"];

// Inserting an element at index 1
const months2 = months.toSpliced(1, 0, "Feb");
console.log(months2); // ["Jan", "Feb", "Mar", "Apr", "May"]

// Deleting two elements starting from index 2
const months3 = months2.toSpliced(2, 2);
console.log(months3); // ["Jan", "Feb", "May"]

// Replacing one element at index 1 with two new elements
const months4 = months3.toSpliced(1, 1, "Feb", "Mar");
console.log(months4); // ["Jan", "Feb", "Mar", "May"]

// Original array is not modified
console.log(months); // ["Jan", "Mar", "Apr", "May"]

Die toSpliced() Methode erstellt immer ein dicht besetztes Array.

const arr = [1, , 3, 4, , 6];
console.log(arr.toSpliced(1, 2)); // [1, 4, undefined, 6]

Die toSpliced() Methode liest die length-Eigenschaft von this. Sie liest dann die benötigten ganzzahligen Schlüssel-Eigenschaften und schreibt sie in das neue Array.

const arrayLike = {
  length: 3,
  unrelated: "foo",
  0: 5,
  2: 4,
};
console.log(Array.prototype.toSpliced.call(arrayLike, 0, 1, 2, 3));
// [2, 3, undefined, 4]

• Polyfill von Array.prototype.toSpliced in core-js
• es-shims polyfill von Array.prototype.toSpliced
• Array.prototype.splice()
• Array.prototype.toReversed()
• Array.prototype.toSorted()
• Array.prototype.with()