JavaScript/Object/prototype/toString

Object.prototype.toString() は、オブジェクトを表す文字列を返すメソッドです。このメソッドは、オブジェクトの型や状態を文字列として表現するために使用されます。

構文

obj.toString()

• obj: 文字列に変換する対象のオブジェクト。

例

オブジェクトを文字列に変換するプログラム

以下のプログラムは、Object.prototype.toString() を使用してオブジェクトを文字列に変換します。

const obj = {
  a: 1,
  b: 2
};

console.log(obj.toString()); // [object Object]

このプログラムでは、obj オブジェクトを文字列に変換しています。デフォルトでは、[object Object] が返されます。

組み込みオブジェクトを文字列に変換するプログラム

以下のプログラムは、Object.prototype.toString() を使用して組み込みオブジェクトを文字列に変換します。

const arr = [1, 2, 3];
const num = 42;
const str = 'Hello';
const date = new Date();

console.log(arr.toString()); // "1,2,3"
console.log(num.toString()); // "42"
console.log(str.toString()); // "Hello"
console.log(date.toString()); // "Thu Oct 05 2023 14:30:00 GMT+0900 (Japan Standard Time)"

このプログラムでは、配列、数値、文字列、日付オブジェクトを文字列に変換しています。それぞれのオブジェクトの toString() メソッドは、オブジェクトの内容を適切な文字列として返します。

カスタムオブジェクトの toString() メソッドをオーバーライドするプログラム

以下のプログラムは、Object.prototype.toString() をオーバーライドしてカスタムオブジェクトの文字列表現を定義します。

function Person(name, age) {
  this.name = name;
  this.age = age;
}

Person.prototype.toString = function() {
  return <code>${this.name} (${this.age} years old)</code>;
};

const person = new Person('Alice', 30);

console.log(person.toString()); // "Alice (30 years old)"

このプログラムでは、Person コンストラクタ関数の toString() メソッドをオーバーライドして、カスタムの文字列表現を定義しています。

注意点

• デフォルトの動作: Object.prototype.toString() のデフォルトの動作は、[object Object] を返します。ただし、多くの組み込みオブジェクトはこのメソッドをオーバーライドして、より有用な文字列を返します。
• 型の確認: Object.prototype.toString() は、オブジェクトの型を確認するためにも使用されます。例えば、Object.prototype.toString.call(obj) を使用すると、obj の型を示す文字列（例えば [object Array] や [object Date]）を取得できます。
• オブジェクト以外の引数: toString() は、オブジェクト以外の値に対して呼び出されると、その値をオブジェクトに変換しようとします。例えば、数値や文字列を渡すと、それらのラッパーオブジェクトの toString() メソッドが呼び出されます。
• プリミティブ値: プリミティブ値（数値、文字列、真偽値など）に対して toString() を呼び出すと、対応するラッパーオブジェクトの toString() メソッドが呼び出されます。

外部リンク

• ECMA-262::20.1.3.6 Object.prototype.toString ( )