String.prototype.valueOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

valueOf() メソッドは、String オブジェクトのプリミティブ値を返します。

試してみましょう

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

構文

js
valueOf() 

返値

与えられた String オブジェクトのプリミティブ値を表す文字列です。

詳細

String オブジェクトの valueOf() メソッドは、String オブジェクトの文字列型としてのプリミティブ値を返します。この値は、String.prototype.toString() の返値と等価です。

このメソッドは通常、JavaScript によって内部的に呼ばれ、コード中で明示的に呼ばれることはありません。

valueOf() メソッドの使用

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

仕様書

Specification
ECMAScript® 2026 Language Specification
# sec-string.prototype.valueof

ブラウザーの互換性

関連情報