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 modifizieren.

Probieren Sie es aus

const str = "The quick brown fox jumps over the lazy dog.";

console.log(str.slice(31));
// Expected output: "the lazy dog."

console.log(str.slice(4, 19));
// Expected output: "quick brown fox"

console.log(str.slice(-4));
// Expected output: "dog."

console.log(str.slice(-9, -5));
// Expected output: "lazy"

Syntax

js
slice(indexStart)
slice(indexStart, indexEnd)

Parameter

indexStart

Der Index des ersten Zeichens, das im zurückgegebenen Teilstring enthalten sein soll.

indexEnd Optional

Der Index des ersten Zeichens, das aus dem 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. Zum Beispiel extrahiert str.slice(4, 8) das fünfte Zeichen bis einschließlich dem achten 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 aus gezählt. Genauer gesagt beginnt in diesem Fall der Teilstring bei max(indexStart + str.length, 0).
  • Wenn indexStart weggelassen, undefined ist oder nicht in eine Nummer umgewandelt werden kann, wird es als 0 behandelt.
  • Wenn indexEnd weggelassen oder undefined ist, oder wenn indexEnd >= str.length, extrahiert slice() bis zum Ende des Strings.
  • Wenn indexEnd < 0, wird der Index vom Ende des Strings aus gezählt. Genauer gesagt endet in diesem Fall der Teilstring 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() zum Erstellen eines neuen Strings

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'

Dieses Beispiel zählt 11 Stellen rückwärts vom Ende des Strings, um den Startindex zu finden, und 16 Stellen vorwärts vom Anfang des Strings, um den Endindex zu finden.

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

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

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

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch