String.prototype.trimStart()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

trimStart() 方法用於 String 值的開頭移除空白字元,並返回一個新字串,該字串的原始字串不會被修改。trimLeft() 是此方法的別名。

試一試

const greeting = "   Hello world!   ";

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

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

語法

js
trimStart()

trimLeft()

引數

無。

返回值

返回一個新字串,表示 str 從開頭(左側)移除空白字元後的結果。空白字元的定義包括 空白字元行終止符

如果 str 的開頭沒有空白字元,仍然會返回一個新字串(本質上是 str 的副本)。

混疊

trim() 標準化之後,引擎也實現了非標準的 trimLeft 方法。然而,為了與 padStart() 保持一致,當該方法標準化時,其名稱被選定為 trimStart。出於 Web 相容性原因,trimLeft 仍然是 trimStart 的別名,它們指向完全相同的函式物件。在某些引擎中,這意味著

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

示例

使用 trimStart()

以下示例從 str 的開頭(左側)移除空白字元,但不會移除其末尾的空白字元。

js
let str = "   foo  ";

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

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

規範

規範
ECMAScript® 2026 語言規範
# sec-string.prototype.trimstart

瀏覽器相容性

另見