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 vorhandene Elemente entfernt oder ersetzt und/oder neue Elemente in place hinzugefügt werden.
Um ein neues Array mit einem entfernt und/oder ersetzten Segment zu erstellen, ohne das ursprüngliche Array zu verändern, verwenden Sie toSpliced()
. Um einen Teil eines Arrays zuzugreifen, ohne es zu modifizieren, siehe slice()
.
Probieren Sie es aus
Syntax
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 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
, wirdstart + array.length
verwendet. - Wenn
start < -array.length
, wird0
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 (undsplice()
ohne Argumente aufgerufen wird), wird nichts gelöscht. Dies ist anders als bei der Übergabe vonundefined
, was in0
umgewandelt wird.
- Ein negativer Index zählt vom Ende des Arrays zurück — wenn
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 durchstart
angegebenen Position ist, werden alle Elemente vonstart
bis zum Ende des Arrays gelöscht. Wenn Sie jedoch irgendeinenitemN
-Parameter angeben möchten, sollten SieInfinity
alsdeleteCount
übergeben, um alle Elemente nachstart
zu löschen, da ein explizitesundefined
in0
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.
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 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.
Beispiele
Entfernen Sie 0 (null) Elemente vor Index 2 und fügen Sie "drum" hinzu
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" hinzu
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 bei Index 0 und fügen Sie "angel" hinzu
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
Entfernen Sie 0 (null) Elemente am letzten Index und fügen Sie "sturgeon" hinzu
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
Entfernen Sie 1 Element bei Index 3
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 bei Index 2 und fügen Sie "trumpet" hinzu
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" hinzu
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
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 ab Index -2
const myFish = ["angel", "clown", "mandarin", "sturgeon"];
const removed = myFish.splice(-2, 1);
// myFish is ["angel", "clown", "sturgeon"]
// removed is ["mandarin"]
Entfernen Sie alle Elemente, beginnend bei Index 2
const myFish = ["angel", "clown", "mandarin", "sturgeon"];
const removed = myFish.splice(2);
// myFish is ["angel", "clown"]
// removed is ["mandarin", "sturgeon"]
Verwendung von splice() auf spärlichen Arrays
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]
Aufruf von splice() bei Nicht-Array-Objekten
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' }
Spezifikationen
Specification |
---|
ECMAScript Language Specification # sec-array.prototype.splice |
Browser-Kompatibilität
BCD tables only load in the browser