Die splice() Methode ändert den Inhalt eines Arrays durch das Hinzufügen neuer und/oder Entfernen alter Elemente.

Syntax

array.splice(index[, deleteCount[, element1[,  element2 [, ...]]]])

Parameter

index
Index ab welchem das Array geändert werden soll. Wenn der Index größer als die Länge des Arrays ist, wird der Index auf die Länge des Arrays gesetzt. Falls der Index negativ ist, beginnt die Änderung entsprechend viele Stellen rückwärts vom Ende des Arrays und wird auf 0 gesetzt wenn der Wert größer als die Länge des Arrays ist.
deleteCount Optional
Anzahl der zu entfernenden alten Array Elemente.
Wenn deleteCount weggelassen wird oder wenn der Wert größer als array.length - start ist (dieses ist, wenn die Anzahl der vom start aus verbliebenen Elemente größer ist), wird das ganze Array gelöscht.
Wenn deleteCount 0 ist, werden keine Elemente entfernt. In diesem Fall sollte man mindestens ein neues Element übergeben.
element1, element2, ... Optional
Die Elemente, die dem Array hinzugefügt werden sollen. Falls keine Elemente angegeben werden, entfernt splice einfach Elemente des Arrays.

Rückgabewert

Ein Array, welches die entfernten Elemente enthält. Wenn nur ein Element entfernt wurde, wird ein Array der länge 1 zurückgegeben. Wenn kein Elemente entfernt werden wird ein leeres Array zurückgegeben.

Beschreibung

Wenn die Anzahl der neu hinzugefügten Elemente ungleich der Anzahl der entfernten Elemente ist, wird die Länge des Arrays geändert.

Beispiele

Entfernen von 0 Elementen vom Index 0 und Einfügen von "drum"

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; 
var removed = myFish.splice(2, 0, 'drum'); 

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

Entfernen von einem Element vom Index 3

var myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon']; 
var removed = myFish.splice(3, 1);

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

Entfernen von einem Element vom Index 2 und Einfügen von "trumpet"

var myFish = ['angel', 'clown', 'drum', 'sturgeon'];
var removed = myFish.splice(2, 1, 'trumpet');

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

Entfernen von 2 Elementen vom Index 0 und Einfügen von "parrot", "anemone" und "blue"

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

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

Entfernen von 2 Elementen vom Index 2

var myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon'];
var removed = myFish.splice(myFish.length - 3, 2);

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

Entfernen von einem Element vom Index -2

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
var removed = myFish.splice(-2, 1);

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

Entfernen von allen Elementen nach Index 2 (inklusiv)

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
var removed = myFish.splice(2);

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

Spezifikationen

Spezifikation Status Kommenter
ECMAScript 3rd Edition (ECMA-262) Standard Initial Definition. Implementiert in JavaScript 1.2.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Array.prototype.splice' in dieser Spezifikation.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Array.prototype.splice' in dieser Spezifikation.
Standard  
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Array.prototype.splice' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

FunktionChromeEdgeFirefoxInternet ExplorerOperaSafari
Grundlegende Unterstützung1 Ja15.5 Ja Ja
FunktionAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Grundlegende Unterstützung Ja Ja Ja4 Ja Ja Ja

Siehe auch

  • push / pop — hinzufügen/löschen von Elementen vom Ende des Arrays
  • unshift / shift — hinzufügen/löschen von Elementen vom Anfang des Arrays
  • concat — Gibt ein neues Array, welches das Array und das/die übergebene(n) Array(s) enthält.

Schlagwörter des Dokuments und Mitwirkende

Zuletzt aktualisiert von: Breaker222,