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), который описывает свойство объекта как функцию, которая вызывается при преобразовании объекта в соответствующее примитивное значение.
Интерактивный пример
Описание
С помощью свойства 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 Language Specification # sec-symbol.toprimitive |
Совместимость с браузерами
BCD tables only load in the browser