Array.prototype.splice()

start

Nullbasierter Index, bei dem die Änderung des Arrays beginnen soll, umgewandelt in eine ganze Zahl.

• Ein negativer Index zählt rückwärts vom Ende des Arrays — wenn -array.length <= start < 0, wird start + array.length verwendet.
• Wenn start < -array.length, wird 0 verwendet.
• Wenn start >= array.length, wird kein Element gelöscht, aber die Methode verhält sich wie eine Hinzufügefunktion, die so viele Elemente hinzufügt, wie bereitgestellt werden.
• Wenn start ausgelassen wird (und splice() ohne Argumente aufgerufen wird), wird nichts gelöscht. Dies unterscheidet sich davon, undefined zu übergeben, was in 0 umgewandelt wird.

deleteCount Optional

Eine ganze Zahl, die die Anzahl der Elemente im Array angibt, die ab start entfernt werden sollen.

Wenn deleteCount weggelassen wird oder sein Wert größer oder gleich der Anzahl der Elemente nach der Position ist, die durch start angegeben wird, werden alle Elemente von start bis zum Ende des Arrays gelöscht. Wenn Sie jedoch einen itemN-Parameter übergeben möchten, sollten Sie Infinity als deleteCount übergeben, um alle Elemente nach start zu löschen, da ein explizites undefined umgewandelt zu 0 wird.

Wenn deleteCount 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 ab start zum Array hinzugefügt werden sollen.

Wenn Sie keine Elemente angeben, entfernt splice() nur Elemente aus dem Array.

Ein Array, das die gelöschten Elemente enthält.

Wenn nur ein Element entfernt wird, wird ein Array mit einem Element zurückgegeben.

Wenn keine Elemente entfernt werden, wird ein leeres Array zurückgegeben.

Die splice()-Methode ist eine Mutationsmethode. Sie kann den Inhalt von this ändern. Wenn sich die Anzahl der einzufügenden Elemente von der Anzahl der zu entfernenden Elemente unterscheidet, wird die length des Arrays ebenfalls geändert. Gleichzeitig wird [Symbol.species] verwendet, um eine neue Array-Instanz zu erstellen, die zurückgegeben wird.

Wenn der gelöschte Abschnitt dünn besetzt ist, ist das durch splice() zurückgegebene Array ebenfalls dünn besetzt, wobei diese entsprechenden Indizes leere Stellen sind.

Die splice()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integer-indizierte Eigenschaften hat. Obwohl Zeichenfolgen ebenfalls array-ähnlich sind, ist diese Methode nicht geeignet, um auf sie angewendet zu werden, da Zeichenfolgen unveränderlich sind.

splice(0, 0, ...elements) fügt Elemente am Anfang des Arrays ein, ähnlich wie unshift().

const myFish = ["clown", "mandarin", "sturgeon"];
const removed = myFish.splice(0, 0, "angel");

// myFish is ["angel", "clown", "mandarin", "sturgeon"]
// no items removed

splice(array.length, 0, ...elements) fügt Elemente am Ende des Arrays ein, ähnlich wie push().

const myFish = ["angel", "clown", "mandarin"];
const removed = myFish.splice(myFish.length, 0, "sturgeon");

// myFish is ["angel", "clown", "mandarin", "sturgeon"]
// no items removed

Die splice()-Methode erhält die Dünnbesetztheit des Arrays.

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

Die splice()-Methode liest die length-Eigenschaft von this. Sie aktualisiert dann die integer-indizierten Eigenschaften und die length-Eigenschaft nach Bedarf.

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

• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.concat()
• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.slice()
• Array.prototype.toSpliced()
• Array.prototype.unshift()