このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 ⁨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 オブジェクトのプリミティブ値を表す文字列です。

詳細

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

ブラウザーの互換性

関連情報