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"

仕様書

ブラウザーの互換性

関連情報

• String.prototype.valueOf()