String.prototype.substring()
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 substring() Methode von String Werten gibt den Teil dieses Strings von dem Startindex bis zu, aber ohne den Endindex, oder bis zum Ende des Strings zurück, wenn kein Endindex angegeben ist.
Probieren Sie es aus
const str = "Mozilla";
console.log(str.substring(1, 3));
// Expected output: "oz"
console.log(str.substring(2));
// Expected output: "zilla"
Syntax
substring(indexStart)
substring(indexStart, indexEnd)
Parameter
indexStart-
Der Index des ersten Zeichens, das in die zurückgegebene Teilzeichenfolge aufgenommen werden soll.
indexEndOptional-
Der Index des ersten Zeichens, das von der zurückgegebenen Teilzeichenfolge ausgeschlossen werden soll.
Rückgabewert
Ein neuer String, der den angegebenen Teil des gegebenen Strings enthält.
Beschreibung
substring() extrahiert Zeichen von indexStart bis zu, aber nicht einschließlich indexEnd. Insbesondere:
- Wenn
indexEndweggelassen oderundefinedist, extrahiertsubstring()Zeichen bis zum Ende des Strings. - Wenn
indexStartgleichindexEndist, gibtsubstring()einen leeren String zurück. - Wenn
indexStartgrößer alsindexEndist, ist die Wirkung vonsubstring()so, als wären die beiden Argumente vertauscht; siehe Beispiel unten.
Jedem Argumentwert, der kleiner als 0 oder größer als str.length ist, wird behandelt, als ob es 0 bzw. str.length wäre.
Jedem Argumentwert, der NaN ist, wird behandelt, als ob es 0 wäre.
Beispiele
Verwendung von substring()
Das folgende Beispiel verwendet substring(), um Zeichen aus dem
String "Mozilla" anzuzeigen:
const anyString = "Mozilla";
console.log(anyString.substring(0, 1)); // "M"
console.log(anyString.substring(1, 0)); // "M"
console.log(anyString.substring(0, 6)); // "Mozill"
console.log(anyString.substring(4)); // "lla"
console.log(anyString.substring(4, 7)); // "lla"
console.log(anyString.substring(7, 4)); // "lla"
console.log(anyString.substring(0, 7)); // "Mozilla"
console.log(anyString.substring(0, 10)); // "Mozilla"
Verwendung von substring() mit der length Eigenschaft
Das folgende Beispiel verwendet die Methode substring() und die
length Eigenschaft, um die letzten Zeichen eines
bestimmten Strings zu extrahieren. Diese Methode kann einfacher zu merken sein, da Sie
die Start- und Endindizes nicht kennen müssen, wie in den obigen Beispielen.
const text = "Mozilla";
// Takes 4 last characters of string
console.log(text.substring(text.length - 4)); // prints "illa"
// Takes 5 last characters of string
console.log(text.substring(text.length - 5)); // prints "zilla"
Der Unterschied zwischen substring() und substr()
Es gibt subtile Unterschiede zwischen den Methoden substring() und
substr(), daher sollten Sie darauf achten, sie nicht zu
verwechseln.
- Die zwei Parameter von
substr()sindstartundlength, während es beisubstring()startundendsind. substr()'sstartIndex wird zum Ende des Strings umwickelt, wenn er negativ ist, währendsubstring()ihn auf0beschränkt.- Negative Längen bei
substr()werden als Null behandelt, währendsubstring()die beiden Indizes vertauscht, wennendkleiner alsstartist.
Außerdem wird substr() als ein veraltetes Merkmal in ECMAScript betrachtet, daher sollte es nach Möglichkeit vermieden werden.
const text = "Mozilla";
console.log(text.substring(2, 5)); // "zil"
console.log(text.substr(2, 3)); // "zil"
Unterschiede zwischen substring() und slice()
Die Methoden substring() und slice() sind fast identisch, aber es gibt ein paar subtile Unterschiede zwischen den beiden, insbesondere in der Art und Weise, wie negative Argumente behandelt werden.
Die Methode substring() vertauscht ihre zwei Argumente, wenn
indexStart größer als indexEnd ist, was bedeutet, dass ein String
immer noch zurückgegeben wird. Die Methode slice()
gibt einen leeren String zurück, wenn dies der Fall ist.
const text = "Mozilla";
console.log(text.substring(5, 2)); // "zil"
console.log(text.slice(5, 2)); // ""
Wenn entweder eines oder beide Argumente negativ oder NaN sind, behandelt die
Methode substring() sie so, als wären sie 0.
console.log(text.substring(-5, 2)); // "Mo"
console.log(text.substring(-5, -2)); // ""
slice() behandelt auch NaN-Argumente als 0, aber wenn es negative Werte
erhält, zählt es rückwärts vom Ende des Strings, um die Indizes zu finden.
console.log(text.slice(-5, 2)); // ""
console.log(text.slice(-5, -2)); // "zil"
Siehe die Seite slice() für weitere Beispiele mit negativen
Zahlen.
Ersetzen einer Teilzeichenfolge innerhalb eines Strings
Das folgende Beispiel ersetzt eine Teilzeichenfolge innerhalb eines Strings. Es ersetzt sowohl einzelne Zeichen als auch Teilzeichenfolgen. Der Funktionsaufruf am Ende des Beispiels erstellt einen String Brave New Web aus dem ursprünglichen String Brave New World.
// Replaces oldS with newS in the string fullS
function replaceString(oldS, newS, fullS) {
for (let i = 0; i < fullS.length; ++i) {
if (fullS.substring(i, i + oldS.length) === oldS) {
fullS =
fullS.substring(0, i) +
newS +
fullS.substring(i + oldS.length, fullS.length);
}
}
return fullS;
}
replaceString("World", "Web", "Brave New World");
Beachten Sie, dass dies zu einer Endlosschleife führen kann, wenn oldS selbst eine
Teilzeichenfolge von newS ist — zum Beispiel, wenn Sie versucht haben,
"World" mit "OtherWorld" hier zu ersetzen.
Eine bessere Methode zum Ersetzen von Strings ist wie folgt:
function replaceString(oldS, newS, fullS) {
return fullS.split(oldS).join(newS);
}
Der obige Code dient als Beispiel für Teilzeichenfolgenoperationen. Wenn Sie
Teilzeichenfolgen ersetzen müssen, möchten Sie meistens
String.prototype.replace() verwenden.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.substring |