https://github.com/ljharb/es-to-primitive

ECMAScript "ToPrimitive" algorithm. Provides ES5 and ES6/ES2015 versions.
https://github.com/ljharb/es-to-primitive

ecmascript javascript primitive spec toprimitive

Last synced: 4 days ago
JSON representation

ECMAScript "ToPrimitive" algorithm. Provides ES5 and ES6/ES2015 versions.

• Host: GitHub
• URL: https://github.com/ljharb/es-to-primitive
• Owner: ljharb
• License: mit
• Created: 2015-03-17T07:23:56.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2024-11-26T18:36:21.000Z (2 months ago)
• Last Synced: 2025-01-22T02:08:42.505Z (11 days ago)
• Topics: ecmascript, javascript, primitive, spec, toprimitive
• Language: JavaScript
• Homepage:
• Size: 138 KB
• Stars: 23
• Watchers: 5
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# es-to-primitive [![Version Badge][npm-version-svg]][package-url]

[![github actions][actions-image]][actions-url]

[![coverage][codecov-image]][codecov-url]

[![dependency status][deps-svg]][deps-url]

[![dev dependency status][dev-deps-svg]][dev-deps-url]

[![License][license-image]][license-url]

[![Downloads][downloads-image]][downloads-url]

[![npm badge][npm-badge-png]][package-url]

ECMAScript “ToPrimitive” algorithm. Provides ES5 and ES2015 versions.

When different versions of the spec conflict, the default export will be the latest version of the abstract operation.

Alternative versions will also be available under an `es5`/`es2015` exported property if you require a specific version.

## Example

```js

var toPrimitive = require('es-to-primitive');

var assert = require('assert');

assert(toPrimitive(function () {}) === String(function () {}));

var date = new Date();

assert(toPrimitive(date) === String(date));

assert(toPrimitive({ valueOf: function () { return 3; } }) === 3);

assert(toPrimitive(['a', 'b', 3]) === String(['a', 'b', 3]));

var sym = Symbol();

assert(toPrimitive(Object(sym)) === sym);

```

## Tests

Simply clone the repo, `npm install`, and run `npm test`

[package-url]: https://npmjs.org/package/es-to-primitive

[npm-version-svg]: https://versionbadg.es/ljharb/es-to-primitive.svg

[deps-svg]: https://david-dm.org/ljharb/es-to-primitive.svg

[deps-url]: https://david-dm.org/ljharb/es-to-primitive

[dev-deps-svg]: https://david-dm.org/ljharb/es-to-primitive/dev-status.svg

[dev-deps-url]: https://david-dm.org/ljharb/es-to-primitive#info=devDependencies

[npm-badge-png]: https://nodei.co/npm/es-to-primitive.png?downloads=true&stars=true

[license-image]: https://img.shields.io/npm/l/es-to-primitive.svg

[license-url]: LICENSE

[downloads-image]: https://img.shields.io/npm/dm/es-to-primitive.svg

[downloads-url]: https://npm-stat.com/charts.html?package=es-to-primitive

[codecov-image]: https://codecov.io/gh/ljharb/es-to-primitive/branch/main/graphs/badge.svg

[codecov-url]: https://app.codecov.io/gh/ljharb/es-to-primitive/

[actions-image]: https://img.shields.io/endpoint?url=https://github-actions-badge-u3jn4tfpocch.runkit.sh/ljharb/es-to-primitive

[actions-url]: https://github.com/ljharb/es-to-primitive/actions