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

String.prototype.trimStart()

Methode

Die Methode <code>trimStart()</code> von <code>String</code>-Werten entfernt Whitespace am Anfang eines Strings und gibt einen neuen String zurück.

Kategorie: method-property

Signatur

trimStart() / trimLeft()

Beschreibung

Die Methode trimStart() von String-Werten entfernt Whitespace am Anfang dieses Strings und gibt einen neuen String zurück, ohne den ursprünglichen String zu verändern. trimLeft() ist ein Alias für diese Methode.

Aliasing

Nachdem trim() standardisiert wurde, implementierten Engines auch die nicht-standardisierte Methode trimLeft. Aus Gründen der Konsistenz mit padStart() wurde bei der Standardisierung jedoch der Name trimStart gewählt. Aus Gründen der Web-Kompatibilität bleibt trimLeft als Alias für trimStart bestehen, und beide verweisen auf exakt dasselbe Funktionsobjekt. In einigen Engines bedeutet dies:

String.prototype.trimLeft.name === "trimStart";

Rückgabewert

Typ
string
Beschreibung
Ein neuer String, der str ohne Whitespace am Anfang (linke Seite) darstellt. Whitespace ist definiert als White-Space-Zeichen plus Line-Terminators. Wenn der Anfang von str keinen Whitespace enthält, wird dennoch ein neuer String zurückgegeben (im Wesentlichen eine Kopie von str).

Beispiele

Verwendung von trimStart()

let str = "   foo  ";

console.log(str.length); // 8

str = str.trimStart();
console.log(str.length); // 5
console.log(str); // 'foo  '