String.prototype.trimStart()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die trimStart()-Methode von String-Werten entfernt Leerzeichen vom Anfang dieser Zeichenfolge und gibt eine neue Zeichenfolge zurück, ohne die ursprüngliche Zeichenfolge zu ändern. trimLeft() ist ein Alias dieser Methode.

Probieren Sie es aus

const greeting = "   Hello world!   ";

console.log(greeting);
// Expected output: "   Hello world!   ";

console.log(greeting.trimStart());
// Expected output: "Hello world!   ";

Syntax

js
trimStart()

trimLeft()

Parameter

Keine.

Rückgabewert

Eine neue Zeichenfolge, die str darstellt und von Leerzeichen am Anfang (linke Seite) befreit ist. Leerzeichen sind definiert als white space-Zeichen plus line terminators.

Wenn der Anfang von str keine Leerzeichen hat, wird trotzdem eine neue Zeichenfolge zurückgegeben (im Wesentlichen eine Kopie von str).

Aliasing

Nachdem trim() standardisiert wurde, haben Engines auch die nicht standardisierte Methode trimLeft implementiert. Allerdings wurde für die Konsistenz mit padStart(), als die Methode standardisiert wurde, deren Name als trimStart gewählt. Aus Gründen der Web-Kompatibilität bleibt trimLeft als ein Alias für trimStart erhalten, und sie beziehen sich auf dasselbe Funktionsobjekt. In einigen Engines bedeutet dies:

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

Beispiele

Verwendung von trimStart()

Das folgende Beispiel entfernt Leerzeichen vom Anfang von str, aber nicht von seinem Ende.

js
let str = "   foo  ";

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

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

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-string.prototype.trimstart

Browser-Kompatibilität

Siehe auch