Symbol.toPrimitive
Symbol.toPrimitive
является символом (symbol), который описывает свойство объекта как функцию, которая вызывается при преобразовании объекта в соответсвующее примитивное значение.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Описание
С помощью свойства 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 | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) Определение 'Symbol.toPrimitive' в этой спецификации. |
Стандарт | Initial definition. |
ECMAScript (ECMA-262) Определение 'Symbol.toPrimitive' в этой спецификации. |
Живой стандарт |
Поддержка браузерами
BCD tables only load in the browser