Symbol.prototype[Symbol.toPrimitive]()

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в разных версиях браузеров. Она доступна во всех браузерах с сентября 2015 года.

Метод [Symbol.toPrimitive]() для значений Symbol возвращает это значение символа.

Синтаксис

symbolValue[Symbol.toPrimitive](hint)

Параметры

hint: Строковое значение, указывающее примитивное значение для возврата. Значение игнорируется.

Возвращаемое значение

Примитивное значение указанного объекта Symbol.

Описание

Метод [Symbol.toPrimitive]() для Symbol возвращает примитивное значение объекта Symbol как тип данных Symbol. Аргумент hint не используется.

JavaScript вызывает метод [Symbol.toPrimitive]() для преобразования объекта в примитивное значение. Вам редко требуется вызывать метод [Symbol.toPrimitive]() самостоятельно; JavaScript автоматически вызывает его при обнаружении объекта, где ожидается примитивное значение.

Примеры

Использование `[Symbol.toPrimitive]()`

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

Спецификации

Спецификация
ECMAScript® 2027 Language Specification # sec-symbol.prototype-%symbol.toprimitive%

Совместимость с браузерами

	Десктопные					Мобильные							Серверные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`@@toPrimitive`	47	15	44	34	10	47	44	34	10	5.0	47	10	1.0.0	1.0	6.0.0

См. также

Symbol.toPrimitive

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/Symbol.toPrimitive