String.prototype.toString()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
toString() は String 値のメソッドで、指定されたオブジェクトを表す文字列を返します。
試してみましょう
const stringObj = new String("foo");
console.log(stringObj);
// 予想される結果: String { "foo" }
console.log(stringObj.toString());
// 予想される結果: "foo"
構文
toString()
引数
なし。
返値
呼び出したオブジェクトを表す文字列です。
詳細
その String オブジェクトは、Object の toString メソッドを上書きします。つまり、Object.prototype.toString() を継承しません。String オブジェクトの toString メソッドは、そのオブジェクトを表す文字列を返します（String.prototype.valueOf() と同等です）。
toString() メソッドは this 値が String プリミティブまたはラッパーオブジェクトであることを要求します。他の this の値に対しては、文字列値に変換しようとせずに TypeError を発生します。
String には [Symbol.toPrimitive]() メソッドがないため、JavaScript は toString() メソッドを、文字列が求められるコンテキスト、例えばテンプレートリテラルで String オブジェクトが使用されると、自動的に呼び出します。しかし、文字列プリミティブ値は文字列に変換するために toString() を呼び出しません。既に文字列なので、変換が実施されないからです。
String.prototype.toString = () => "Overridden";
console.log(`${"foo"}`); // "foo"
console.log(`${new String("foo")}`); // "Overridden"
例
toString() メソッドを使う
以下の例は、String オブジェクトを表す文字列の値を表示します。
const x = new String("Hello world");
console.log(x.toString()); // "Hello world"
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.tostring |
ブラウザーの互換性
Loading…