to-primitive-x
Converts a JavaScript object to a primitive value.
Version: 1.1.0
Author: Xotic750 Xotic750@gmail.com
License: MIT
Copyright: Xotic750
module.exports(input, [prefferedtype]) ⇒ string | number ⏏
This method converts a JavaScript object to a primitive value. Note: When toPrimitive is called with no hint, then it generally behaves as if the hint were Number. However, objects may over-ride this behaviour by defining a @@toPrimitive method. Of the objects defined in this specification only Date objects (see 20.3.4.45) and Symbol objects (see 19.4.3.4) over-ride the default ToPrimitive behaviour. Date objects treat no hint as if the hint were String.
Kind: Exported function
Returns: string | number - The converted input as a primitive.
Throws:
TypeErrorIf unable to convert input to a primitive.
| Param | Type | Description |
|---|---|---|
| input | * |
The input to convert. |
| [prefferedtype] | constructor |
The preffered type (String or Number). |
Example
var toPrimitive = require('to-primitive-x');
var date = new Date(0);
toPrimitive(date)); // Thu Jan 01 1970 01:00:00 GMT+0100 (CET)
toPrimitive(date, String)); // Thu Jan 01 1970 01:00:00 GMT+0100 (CET)
toPrimitive(date, Number)); // 0