Array.prototype.splice()

start

Nullbasierter Index, an dem begonnen wird, das Array zu ändern, in eine Ganzzahl umgewandelt.

• 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, wird 0 verwendet.
• Wenn start >= array.length, wird kein Element gelöscht, aber die Methode verhält sich wie eine Hinzufügemethode und fügt so viele Elemente hinzu, wie angegeben werden.
• Wenn start ausgelassen wird (und splice() ohne Argumente aufgerufen wird), wird nichts gelöscht. Dies ist anders als bei der Übergabe von undefined, was in 0 umgewandelt wird.

deleteCount Optional

Eine Ganzzahl, die die Anzahl der zu entfernenden Elemente im Array ab start angibt.

Wenn deleteCount weggelassen wird oder wenn 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 deleteCount übergeben, um alle Elemente nach start zu löschen, da ein explizites undefined in 0 umgewandelt 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.

Falls keine Elemente angegeben werden, 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 die angegebene Anzahl der einzufügenden Elemente von der Anzahl der zu entfernenden Elemente abweicht, wird sich auch die length des Arrays ändern. Gleichzeitig wird [Symbol.species] verwendet, um eine neue Array-Instanz zu erstellen, die zurückgegeben wird.

Wenn der gelöschte Teil spärlich ist, ist das von splice() zurückgegebene Array auch spärlich, wobei diese entsprechenden Indizes leere Plätze sind.

Die splice()-Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und Integer-Schlüsseleigenschaften hat. Obwohl Strings auch array-ähnlich sind, ist diese Methode nicht geeignet, um auf ihnen angewendet zu werden, da Strings unveränderlich sind.

splice(0, 0, ...elements) fügt Elemente am Anfang des Arrays ein 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 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 Sparsamkeit 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 integerbasierten 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()