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 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  '

仕様書

Specification

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

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年8月22日 by MDN contributors.

View this page on GitHub • Report a problem with this content

String.prototype.trimStart()

In this article

試してみましょう

構文

引数

返値

別名

例

trimStart() の使用

仕様書

ブラウザーの互換性

関連情報

Help improve MDN