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

瀏覽器相容性

另見