String.prototype.slice()

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 slice()-Methode von String-Werten extrahiert einen Abschnitt dieses Strings und gibt ihn als neuen String zurück, ohne den ursprünglichen String zu verändern.

Probieren Sie es aus

Syntax

js
slice(indexStart)
slice(indexStart, indexEnd)

Parameter

indexStart

Der Index des ersten Zeichens, das in den zurückgegebenen Teilstring einbezogen werden soll.

indexEnd Optional

Der Index des ersten Zeichens, das vom zurückgegebenen Teilstring ausgeschlossen wird.

Rückgabewert

Ein neuer String, der den extrahierten Abschnitt des Strings enthält.

Beschreibung

slice() extrahiert den Text aus einem String und gibt einen neuen String zurück.

slice() extrahiert bis, aber nicht einschließlich indexEnd. Beispielsweise extrahiert str.slice(4, 8) das fünfte bis achte Zeichen (Zeichen mit den Indizes 4, 5, 6 und 7):

              indexStart        indexEnd
                  ↓               ↓
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |
| T | h | e |   | m | i | r | r | o | r |

                  m   i   r   r
                 _______________
                      ↑
                    Result
  • Wenn indexStart >= str.length, wird ein leerer String zurückgegeben.
  • Wenn indexStart < 0, wird der Index vom Ende des Strings gezählt. Formaler ausgedrückt beginnt der Teilstring in diesem Fall bei max(indexStart + str.length, 0).
  • Wenn indexStart weggelassen wird, undefiniert ist oder nicht in eine Nummer umgewandelt werden kann, wird es als 0 behandelt.
  • Wenn indexEnd weggelassen oder undefiniert ist, oder wenn indexEnd >= str.length, extrahiert slice() bis zum Ende des Strings.
  • Wenn indexEnd < 0, wird der Index von Ende des Strings gezählt. Formaler ausgedrückt endet der Teilstring in diesem Fall bei max(indexEnd + str.length, 0).
  • Wenn indexEnd <= indexStart nach der Normalisierung negativer Werte (d.h. indexEnd repräsentiert ein Zeichen, das vor indexStart liegt), wird ein leerer String zurückgegeben.

Beispiele

Verwenden von slice(), um einen neuen String zu erstellen

Das folgende Beispiel verwendet slice(), um einen neuen String zu erstellen.

js
const str1 = "The morning is upon us."; // The length of str1 is 23.
const str2 = str1.slice(1, 8);
const str3 = str1.slice(4, -2);
const str4 = str1.slice(12);
const str5 = str1.slice(30);
console.log(str2); // he morn
console.log(str3); // morning is upon u
console.log(str4); // is upon us.
console.log(str5); // ""

Verwenden von slice() mit negativen Indizes

Das folgende Beispiel verwendet slice() mit negativen Indizes.

js
const str = "The morning is upon us.";
str.slice(-3); // 'us.'
str.slice(-3, -1); // 'us'
str.slice(0, -1); // 'The morning is upon us'
str.slice(4, -1); // 'morning is upon us'

In diesem Beispiel wird rückwärts vom Ende des Strings um 11 gezählt, um den Startindex zu finden, und vorwärts vom Anfang des Strings um 16, um den Endindex zu finden.

js
console.log(str.slice(-11, 16)); // "is u"

Hier wird vorwärts vom Anfang um 11 gezählt, um den Startindex zu finden, und rückwärts vom Ende um 7, um den Endindex zu finden.

js
console.log(str.slice(11, -7)); // " is u"

Diese Argumente zählen rückwärts vom Ende um 5, um den Startindex zu finden, und rückwärts vom Ende um 1, um den Endindex zu finden.

js
console.log(str.slice(-5, -1)); // "n us"

Spezifikationen

Specification
ECMAScript Language Specification
# sec-string.prototype.slice

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch