String.prototype.valueOf()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

valueOf() 方法 String 值返回此字符串值。

试一试

const stringObj = new String("foo");

console.log(stringObj);
// Expected output: String { "foo" }

console.log(stringObj.valueOf());
// Expected output: "foo"

语法

js
valueOf()

参数

无。

返回值

一个代表给定 String 对象的原始值的字符串。

描述

valueOf() 方法 String 返回 String 对象的原始值,其数据类型为字符串。此值等同于 String.prototype.toString()

此方法通常由 JavaScript 在内部调用,而不是在代码中显式调用。

示例

使用 valueOf()

js
const x = new String("Hello world");
console.log(x.valueOf()); // 'Hello world'

规范

规范
ECMAScript® 2026 语言规范
# sec-string.prototype.valueof

浏览器兼容性

另见