Array.prototype.splice()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die splice()-Methode von Array-Instanzen ändert den Inhalt eines Arrays, indem sie vorhandene Elemente entfernt oder ersetzt und/oder neue Elemente vor Ort hinzufügt.

Um ein neues Array mit einem entfernten und/oder ersetzten Segment zu erstellen, ohne das Original-Array zu verändern, verwenden Sie toSpliced(). Um auf einen Teil eines Arrays zuzugreifen, ohne es zu verändern, siehe slice().

Probieren Sie es aus

const months = ["Jan", "March", "April", "June"];
months.splice(1, 0, "Feb");
// Inserts at index 1
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "June"]

months.splice(4, 1, "May");
// Replaces 1 element at index 4
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "May"]

Syntax

js
splice(start)
splice(start, deleteCount)
splice(start, deleteCount, item1)
splice(start, deleteCount, item1, item2)
splice(start, deleteCount, item1, item2, /* …, */ itemN)

Parameter

start

Nullbasierter Index, an dem die Änderung des Arrays beginnt, in eine ganze Zahl 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 wird als Hinzufügungsfunktion wirken und so viele Elemente hinzufügen, wie bereitgestellt werden.
  • Wenn start weggelassen wird (und splice() ohne Argumente aufgerufen wird), wird nichts gelöscht. Dies unterscheidet sich davon, undefined zu übergeben, das in 0 umgewandelt wird.
deleteCount Optional

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

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 einen itemN-Parameter übergeben 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 sollen.

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

Rückgabewert

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.

Beschreibung

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

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

Die splice()-Methode ist generisch. Es wird nur erwartet, dass der this-Wert eine length-Eigenschaft und integer-basierte Eigenschaften hat. Obwohl Zeichenketten auch array-ähnlich sind, ist diese Methode nicht geeignet, um darauf angewendet zu werden, da Zeichenketten unveränderlich sind.

Beispiele

Entfernen Sie 0 (null) Elemente vor Index 2 und fügen Sie "drum" ein

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

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

Entfernen Sie 0 (null) Elemente vor Index 2 und fügen Sie "drum" und "guitar" ein

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

// myFish is ["angel", "clown", "drum", "guitar", "mandarin", "sturgeon"]
// removed is [], no elements removed

Entfernen Sie 0 (null) Elemente an Index 0 und fügen Sie "angel" ein

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

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

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

Entfernen Sie 0 (null) Elemente am letzten Index und fügen Sie "sturgeon" ein

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

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

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

Entfernen Sie 1 Element an Index 3

js
const myFish = ["angel", "clown", "drum", "mandarin", "sturgeon"];
const removed = myFish.splice(3, 1);

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

Entfernen Sie 1 Element an Index 2 und fügen Sie "trumpet" ein

js
const myFish = ["angel", "clown", "drum", "sturgeon"];
const removed = myFish.splice(2, 1, "trumpet");

// myFish is ["angel", "clown", "trumpet", "sturgeon"]
// removed is ["drum"]

Entfernen Sie 2 Elemente ab Index 0 und fügen Sie "parrot", "anemone" und "blue" ein

js
const myFish = ["angel", "clown", "trumpet", "sturgeon"];
const removed = myFish.splice(0, 2, "parrot", "anemone", "blue");

// myFish is ["parrot", "anemone", "blue", "trumpet", "sturgeon"]
// removed is ["angel", "clown"]

Entfernen Sie 2 Elemente, beginnend bei Index 2

js
const myFish = ["parrot", "anemone", "blue", "trumpet", "sturgeon"];
const removed = myFish.splice(2, 2);

// myFish is ["parrot", "anemone", "sturgeon"]
// removed is ["blue", "trumpet"]

Entfernen Sie 1 Element von Index -2

js
const myFish = ["angel", "clown", "mandarin", "sturgeon"];
const removed = myFish.splice(-2, 1);

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

Entfernen Sie alle Elemente ab Index 2

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

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

Verwendung von splice() auf dünn besetzten Arrays

Die splice()-Methode bewahrt die Dünnbesetzung des Arrays.

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

Aufrufen von splice() auf Nicht-Array-Objekten

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

js
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' }

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-array.prototype.splice

Browser-Kompatibilität

Siehe auch