String.prototype.toString()

Baseline 広く利用可能

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

toString() は String 値のメソッドで、指定されたオブジェクトを表す文字列を返します。

試してみましょう

const stringObj = new String("foo");

console.log(stringObj);
// 予想される結果: String { "foo" }

console.log(stringObj.toString());
// 予想される結果: "foo"

詳細

その String オブジェクトは、Object の toString メソッドを上書きします。つまり、Object.prototype.toString() を継承しません。String オブジェクトの toString メソッドは、そのオブジェクトを表す文字列を返します（String.prototype.valueOf() と同等です）。

toString() メソッドは this 値が String プリミティブまたはラッパーオブジェクトであることを要求します。他の this の値に対しては、文字列値に変換しようとせずに TypeError を発生します。

String には [Symbol.toPrimitive]() メソッドがないため、JavaScript は toString() メソッドを、文字列が求められるコンテキスト、例えばテンプレートリテラルで String オブジェクトが使用されると、自動的に呼び出します。しかし、文字列プリミティブ値は文字列に変換するために toString() を呼び出しません。既に文字列なので、変換が実施されないからです。

js
String.prototype.toString = () => "Overridden";
console.log(`${"foo"}`); // "foo"
console.log(`${new String("foo")}`); // "Overridden"

例

toString() メソッドを使う

以下の例は、String オブジェクトを表す文字列の値を表示します。

js
const x = new String("Hello world");

console.log(x.toString()); // "Hello world"

仕様書

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

ブラウザーの互換性

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

MDN の改良に協力

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

はいいいえ

協力方法を知る

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

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

String.prototype.toString()

目次

試してみましょう

構文

引数

返値

詳細

例

toString() メソッドを使う

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力