Object.prototype.valueOf()

valueOf() 메소드는 특정 객체의 원시 값을 반환한다.

구문

object.valueOf()

반환값

특정 객체의 원시값

설명

자바스크립트는 어떤 객체를 원시값으로 변환하기 위해  valueOf 메소드를 호출한다. 이 메소드를 직접 호출할 필요는 거의 없다; 원시값이 기대되는 곳에서 어떤 객체를 만났을 때 자바스크립트가 알아서 그것을 호출하기 때문이다.

기본적으로,  valueOf 메소드는 Object 로 부터 모든 객체에 상속된다. 모든 내장 객체가 적당한 값을 반환하기 위해 이 메소드에 우선한다. 만약 어떤 객체가 원시값을 가지고 있지 않다면, valueOf 가 객체 자신을 반환한다.

자신만의 코드내에서 내장객체를 원시값으로 변환하기 위해 valueOf 를 사용할 수 있다.  커스텀 객체를 생성할 때, 기본 Object 메소드 대신 커스텀 메소드를 호출하기 위해 Object.prototype.valueOf() 를 덮어쓸 수 있다.

커스텀 객체를 위해 valueOf 덮어씌우기

기본 valueOf 메소드 대신 호출될 함수를 생성할 수 있다. 그 함수는 매개변수가 없어야 한다.

myNumberType 의 객체 형태가 있고 그 객체의 valueOf 메소드를 생성하기 원한다고 하자. 다음의 코드는 그 객체의 valueOf 메소드에 사용자 정의 함수를 할당한다:

myNumberType.prototype.valueOf = function() { return customPrimitiveValue; };

놓인 앞선 코드에서 어떤 myNumberType 객체 형태가 원시값으로 표현되는 문맥에서 사용되는 언제든 자바스크립트가 자동으로 앞선 코드에서 정의된 그 함수를 호출한다.

어떤 객체의 valueOf 메소드는 일반적으로 자바스크립트에 의해 호출되나 다음과 같이 직접 호출도 가능하다:

myNumber.valueOf()

예시

valueOf 사용

function myNumberType(n) {
    this.number = n;
}

myNumberType.prototype.valueOf = function() {
    return this.number;
};

myObj = new myNumberType(4);
myObj + 3; // 7

명세

브라우저 호환성

함께 보기

• Object.prototype.toString()
• parseInt()