String.prototype.trimStart()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

trimStart() は String 値のメソッドで、元の文字列を変更せずに、文字列の先頭のホワイトスペースを削除した新しい文字列を返します。trimLeft() はこのメソッドの別名です。

試してみましょう

const greeting = "   Hello world!   ";

console.log(greeting);
// 予想される結果: "   Hello world!   ";

console.log(greeting.trimStart());
// 予想される結果: "Hello world!   ";

構文

js
trimStart()

trimLeft()

引数

なし。

返値

str の先頭のホワイトスペースを取り除いた新しい文字列です。ホワイトスペースはホワイトスペース文字と改行文字で定義します。

str の先頭にホワイトスペースがなかった場合でも、新しい文字列が返されます（基本的には str のコピー）。

別名

trim() が標準化された後、エンジンは標準外の trimLeft メソッドも実装しました。しかし padStart() との整合を取るため、このメソッドが標準化された際、trimStart という名前が選択されました。ウェブの互換性の理由から、trimLeft も trimStart の別名として残っており、全く同じ関数オブジェクトを示します。エンジンによっては次のような意味になります。

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® 2027 Language Specification
# sec-string.prototype.trimstart

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年8月22日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

String.prototype.trimStart()

目次

試してみましょう

構文

引数

返値

別名

例

trimStart() の使用

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力