String.prototype.toString()

StringtoString() 方法返回该字符串的值。

尝试一下

语法

js
toString()

返回值

表示指定字符串值的字符串。

描述

String 对象重写了 ObjecttoString 方法;它不会继承 Object.prototype.toString()。对于 String 值,toString 方法返回字符串本身(如果它是原始值)或 String 对象封装的字符串。它的实现与 String.prototype.valueOf() 完全相同。

toString() 方法要求其 this 值为 String 原始值或封装对象。对于其他 this 值,它会抛出 TypeError 而不尝试将其转换为字符串值。

由于 String 没有 [@@toPrimitive]() 方法,当一个 String 对象在期望字符串的上下文中使用时(比如在模板字面量中),JavaScript 会自动调用 toString() 方法。然而,String 原始值不会使用 toString() 方法来进行字符串强制转换——因为它们已经是字符串,所以不会进行转换。

js
String.prototype.toString = () => "已经被重写了";
console.log(`${"foo"}`); // "foo"
console.log(`${new String("foo")}`); // "已经被重写了"

示例

使用 toString()

以下示例输出一个 String 对象的字符串值:

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

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

规范

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

浏览器兼容性

BCD tables only load in the browser

参见