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.

trimStart() メソッドは、元の文字列を変更せずに、文字列の先頭のホワイトスペースを削除した新しい文字列を返します。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 メソッドも実装しました。しかし padEnd() との整合を取るため、このメソッドが標準化された際、trimStart という名前が選択されました。ウェブの互換性の理由から、trimLefttrimStart の別名として残っており、全く同じ関数オブジェクトを示します。エンジンによっては次のような意味になります。

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  '

仕様書

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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
trimStart

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Uses a non-standard name.
Has more compatibility info.

関連情報