Symbol.prototype[Symbol.toPrimitive]()

Baseline Widely available

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

[Symbol.toPrimitive]() 메서드는 Symbol 객체를 원시 값으로 변환합니다.

구문

js
symbolValue[Symbol.toPrimitive](hint)

매개변수

hint

반환할 원시 값을 가리키는 문자열 값입니다. 값은 무시합니다.

반환 값

명시된 Symbol 객체의 원시 값입니다.

설명

Symbol[Symbol.toPrimitive]() 메서드는 Symbol 객체의 원시 값을 Symbol 데이터 유형으로 반환합니다. hint 인자는 사용되지 않습니다.

JavaScript는 객체를 원시 값으로 변환하기 위해 [Symbol.toPrimitive]() 메서드를 호출합니다. 여러분은 [Symbol.toPrimitive]() 메서드를 직접 호출할 필요가 거의 없습니다. 원시 값이 예상되는 객체를 만나면 JavaScript가 자동으로 호출합니다.

예제

[Symbol.toPrimitive]() 사용하기

js
const sym = Symbol("example");
sym === sym[Symbol.toPrimitive](); // true

명세서

Specification
ECMAScript® 2025 Language Specification
# sec-symbol.prototype-%symbol.toprimitive%

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
[Symbol.toPrimitive]

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

같이 보기