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), который описывает свойство объекта как функцию, которая вызывается при преобразовании объекта в соответствующее примитивное значение.
Интерактивный пример
const object1 = {
[Symbol.toPrimitive](hint) {
if (hint === "number") {
return 42;
}
return null;
},
};
console.log(+object1);
// Expected output: 42
Описание
С помощью свойства Symbol.toPrimitive
(которое описывается как функция), объект может быть приведён к примитивному типу. Функция вызывается со строковым аргументом hint
, который передаёт желаемый тип примитива. Значением аргумента hint
может быть одно из следующих значений "number"
, "string"
, и "default"
.
Примеры
Описанные ниже примеры показывают как с помощью свойства Symbol.toPrimitive
можно привести объект к примитивному типу.
// Объект без свойства Symbol.toPrimitive
var obj1 = {};
console.log(+obj1); // NaN
console.log(`${obj1}`); // "[object Object]"
console.log(obj1 + ""); // "[object Object]"
// Объект со свойством Symbol.toPrimitive
var obj2 = {
[Symbol.toPrimitive](hint) {
if (hint == "number") {
return 10;
}
if (hint == "string") {
return "hello";
}
return true;
},
};
console.log(+obj2); // 10 -- желаемый тип (hint) - "number"
console.log(`${obj2}`); // "hello" -- желаемый тип (hint) - "string"
console.log(obj2 + ""); // "true" -- желаемый тип (hint) - "default"
Спецификации
Specification |
---|
ECMAScript® 2025 Language Specification # sec-symbol.toprimitive |
Совместимость с браузерами
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toPrimitive |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support