Array.prototype.slice()

Probieren Sie es aus

const animals = ["ant", "bison", "camel", "duck", "elephant"];

console.log(animals.slice(2));
// Expected output: Array ["camel", "duck", "elephant"]

console.log(animals.slice(2, 4));
// Expected output: Array ["camel", "duck"]

console.log(animals.slice(1, 5));
// Expected output: Array ["bison", "camel", "duck", "elephant"]

console.log(animals.slice(-2));
// Expected output: Array ["duck", "elephant"]

console.log(animals.slice(2, -1));
// Expected output: Array ["camel", "duck"]

console.log(animals.slice());
// Expected output: Array ["ant", "bison", "camel", "duck", "elephant"]

Syntax

slice()
slice(start)
slice(start, end)

Parameter

start Optional

Nullbasierter Index, bei dem die Extraktion beginnt, in eine Ganzzahl umgewandelt.

• Ein negativer Index zhlt vom Ende des Arrays zurck wenn -array.length <= start < 0, wird start + array.length verwendet.
• Wenn start < -array.length oder start weggelassen wird, wird 0 verwendet.
• Wenn start >= array.length, wird ein leeres Array zurckgegeben.

end Optional

Nullbasierter Index, bei dem die Extraktion endet, in eine Ganzzahl umgewandelt. slice() extrahiert bis, aber nicht einschlielich end.

• Ein negativer Index zhlt vom Ende des Arrays zurck wenn -array.length <= end < 0, wird end + array.length verwendet.
• Wenn end < -array.length, wird 0 verwendet.
• Wenn end >= array.length oder end weggelassen oder undefined ist, wird array.length verwendet, wodurch alle Elemente bis zum Ende extrahiert werden.
• Wenn end eine Position impliziert, die vor oder an der Position liegt, die start impliziert, wird ein leeres Array zurckgegeben.

Rckgabewert

Ein neues Array, das die extrahierten Elemente enthlt.

Beschreibung

Die slice() Methode ist eine kopierende Methode. Sie verndert this nicht, sondern gibt stattdessen eine flache Kopie zurck, die einige der gleichen Elemente wie die des ursprnglichen Arrays enthlt.

Die slice() Methode bewahrt leere Stellen. Wenn der ausgeschnittene Teil lckenhaft ist, ist das zurckgegebene Array ebenfalls lckenhaft.

Die slice() Methode ist generisch. Sie erwartet nur, dass der this-Wert eine length-Eigenschaft und integerindizierte Eigenschaften hat.

Beispiele

Einen Teil eines vorhandenen Arrays zurckgeben

const fruits = ["Banana", "Orange", "Lemon", "Apple", "Mango"];
const citrus = fruits.slice(1, 3);

// fruits contains ['Banana', 'Orange', 'Lemon', 'Apple', 'Mango']
// citrus contains ['Orange','Lemon']

In diesem Beispiel extrahiert slice(1, 3) Elemente vom Index 1 bis, aber nicht einschlielich, Index 3, was zu einem neuen Array ['Orange', 'Lemon'] fhrt.

Den Endparameter weglassen

const fruits = ["Apple", "Banana", "Orange", "Mango", "Pineapple"];

const tropical = fruits.slice(2);
console.log(tropical); // ['Orange', 'Mango', 'Pineapple']

In diesem Beispiel extrahiert slice(2) Elemente vom Index 2 bis zum Ende des Arrays.

Verwenden negativer Indizes

const fruits = ["Apple", "Banana", "Orange", "Mango", "Pineapple"];

const lastTwo = fruits.slice(-2);
console.log(lastTwo); // ['Mango', 'Pineapple']

In diesem Beispiel extrahiert slice(-2) die letzten zwei Elemente des Arrays. Bei Verwendung eines negativen Index mit der slice Methode werden negative Indizes vom Ende des Arrays aus gezhlt, beginnend bei -1 fr das letzte Element, -2 fr das vorletzte Element und so weiter. Der negative Index -2 selbst ist eingeschlossen, da er der Ausgangspunkt der Extraktion ist.

|     |     |     |     |     |
|  S  |  L  |  I  |  C  |  E  |
|     |     |     |     |     |
  -5    -4    -3    -2    -1

<--- read from reverse

Verwenden eines positiven Startindex und eines negativen Endindex

const fruits = ["Apple", "Banana", "Orange", "Mango", "Pineapple"];

// Using positive start index and negative end index
const sliceExample = fruits.slice(1, -1);
console.log(sliceExample); // ['Banana', 'Orange', 'Mango']

In diesem Beispiel beginnt slice(1, -1) mit der Extraktion ab Index 1 und geht bis zu, aber schliet nicht ein, das Element bei Index -1 (welches das letzte Element ist). Dies ergibt ein neues Array mit ['Banana', 'Orange', 'Mango']. Die slice Methode schliet immer das Element am angegebenen Endindex aus, unabhngig davon, ob es positiv oder negative ist.

read from start --->

   0     1     2     3     4
|     |     |     |     |     |
|  S  |  L  |  I  |  C  |  E  |
|     |     |     |     |     |
  -5    -4    -3    -2    -1

<--- read from reverse

Verwenden von slice mit Arrays von Objekten

Im folgenden Beispiel erstellt slice ein neues Array, newCar, aus myCar. Beide beinhalten eine Referenz zum Objekt myHonda. Wenn die Farbe von myHonda auf Lila gendert wird, reflektieren beide Arrays die nderung.

// Using slice, create newCar from myCar.
const myHonda = {
  color: "red",
  wheels: 4,
  engine: { cylinders: 4, size: 2.2 },
};
const myCar = [myHonda, 2, "cherry condition", "purchased 1997"];
const newCar = myCar.slice(0, 2);

console.log("myCar =", myCar);
console.log("newCar =", newCar);
console.log("myCar[0].color =", myCar[0].color);
console.log("newCar[0].color =", newCar[0].color);

// Change the color of myHonda.
myHonda.color = "purple";
console.log("The new color of my Honda is", myHonda.color);

console.log("myCar[0].color =", myCar[0].color);
console.log("newCar[0].color =", newCar[0].color);

Dieses Skript schreibt:

myCar = [
  { color: 'red', wheels: 4, engine: { cylinders: 4, size: 2.2 } },
  2,
  'cherry condition',
  'purchased 1997'
]
newCar = [ { color: 'red', wheels: 4, engine: { cylinders: 4, size: 2.2 } }, 2 ]
myCar[0].color = red
newCar[0].color = red
The new color of my Honda is purple
myCar[0].color = purple
newCar[0].color = purple

Aufrufen von slice() bei nicht-Array-Objekten

Die slice() Methode liest die length-Eigenschaft von this. Sie liest dann die integerindizierten Eigenschaften von start bis end und definiert sie auf einem neu erstellten Array.

const arrayLike = {
  length: 3,
  0: 2,
  1: 3,
  2: 4,
  3: 33, // ignored by slice() since length is 3
};
console.log(Array.prototype.slice.call(arrayLike, 1, 3));
// [ 3, 4 ]

Verwenden von slice() um array-hnliche Objekte in Arrays zu konvertieren

Die slice() Methode wird oft mit bind() und call() verwendet, um eine Hilfsmethode zu erstellen, die ein array-hnliches Objekt in ein Array konvertiert.

// slice() is called with `this` passed as the first argument
const slice = Function.prototype.call.bind(Array.prototype.slice);

function list() {
  return slice(arguments);
}

const listResult = list(1, 2, 3); // [1, 2, 3]

Verwenden von slice() bei lckenhaften Arrays

Das von slice() zurckgegebene Array kann lckenhaft sein, wenn die Quelle lckenhaft ist.

console.log([1, 2, , 4, 5].slice(1, 4)); // [2, empty, 4]

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill von Array.prototype.slice in core-js
• es-shims Polyfill von Array.prototype.slice
• Leitfaden fr indizierte Sammlungen
• Array
• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.concat()
• Array.prototype.splice()
• TypedArray.prototype.slice()
• String.prototype.slice()