Start · Sprachen · JavaScript · Referenz · String.prototype.slice()

String.prototype.slice()

Methode

Die Methode <code>slice()</code> von <code>String</code>-Werten extrahiert einen Abschnitt aus dem String und gibt ihn als neuen String zurück, ohne das Original zu verändern.

Kategorie: method-property

Signatur

slice(indexStart) / slice(indexStart, indexEnd)

Beschreibung

Die Methode slice() von String-Werten extrahiert einen Abschnitt dieses Strings und gibt ihn als neuen String zurück, ohne den ursprünglichen String zu verändern.

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

slice() extrahiert bis, aber ohne indexEnd. Zum Beispiel extrahiert str.slice(4, 8) das fünfte bis achte Zeichen (Zeichen mit den Indizes 4, 5, 6 und 7).

  • 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, undefined ist oder nicht in eine Zahl konvertiert werden kann, wird er als 0 behandelt.
  • Wenn indexEnd weggelassen wird 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 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 ist (d. h. indexEnd ein Zeichen darstellt, das vor indexStart liegt), wird ein leerer String zurückgegeben.

Parameter

Name Typ Default Beschreibung
$indexStart Pflicht number Der Index des ersten Zeichens, das in den zurückgegebenen Teilstring aufgenommen werden soll.
$indexEnd number Der Index des ersten Zeichens, das aus dem zurückgegebenen Teilstring ausgeschlossen werden soll.

Rückgabewert

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

Beispiele

slice() zum Erstellen eines neuen Strings verwenden

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); // ""

slice() mit negativen Indizes verwenden

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'

Rückwärts vom Ende und vorwärts vom Anfang

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

Vorwärts vom Anfang und rückwärts vom Ende

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

Beide Indizes rückwärts vom Ende

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