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 dieses Strings und gibt einen neuen String zurück, ohne den ursprünglichen String zu ändern. trimLeft() ist ein Alias für diese 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

Ein neuer String, der str ohne Leerzeichen am Anfang (linke Seite) repräsentiert. Leerzeichen sind definiert als white space-Zeichen plus line terminators.

Wenn der Anfang von str keine Leerzeichen enthält, wird trotzdem ein neuer String zurückgegeben (im Wesentlichen eine Kopie von str).

Aliasing

Nachdem trim() standardisiert wurde, haben Engines auch die nicht standardisierte Methode trimLeft implementiert. Für Konsistenz mit padStart() wurde bei der Standardisierung der Name trimStart gewählt. Aus Gründen der Webkompatibilität bleibt trimLeft als 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, jedoch 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® 2025 Language Specification
# sec-string.prototype.trimstart

Browser-Kompatibilität

Siehe auch