Converts a JavaScript object to a primitive value.
npm install to-primitive-x href="https://travis-ci.org/Xotic750/to-primitive-x"
title="Travis status"> src="https://travis-ci.org/Xotic750/to-primitive-x.svg?branch=master"
alt="Travis status" height="18">
href="https://david-dm.org/Xotic750/to-primitive-x"
title="Dependency status"> alt="Dependency status" height="18"/>
href="https://david-dm.org/Xotic750/to-primitive-x?type=dev"
title="devDependency status"> alt="devDependency status" height="18"/>
href="https://badge.fury.io/js/to-primitive-x"
title="npm version"> alt="npm version" height="18">
href="https://www.jsdelivr.com/package/npm/to-primitive-x"
title="jsDelivr hits"> alt="jsDelivr hits" height="18">
href="https://bettercodehub.com/results/Xotic750/to-primitive-x"
title="bettercodehub score"> alt="bettercodehub score" height="18">
href="https://coveralls.io/github/Xotic750/to-primitive-x?branch=master"
title="Coverage Status"> alt="Coverage Status" height="18">
Converts a JavaScript object to a primitive value.
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:
- TypeError If unable to convert input to a primitive.
| Param | Type | Description |
| --------------- | ------------------------ | -------------------------------------- |
| input | \* | The input to convert. |
| [prefferedtype] | constructor | The preffered type (String or Number). |
Example
``js
import toPrimitive from 'to-primitive-x';
const date = new Date(0);
console.log(toPrimitive(date)); // Thu Jan 01 1970 01:00:00 GMT+0100 (CET)
console.log(toPrimitive(date, String)); // Thu Jan 01 1970 01:00:00 GMT+0100 (CET)
console.log(toPrimitive(date, Number)); // 0
``