es-to-primitive
Advanced tools
ECMAScript “ToPrimitive” algorithm. Provides ES5 and ES2015 versions.
The es-to-primitive npm package provides functionality to convert a JavaScript value to its primitive equivalent, following the ECMAScript specification for ToPrimitive abstract operation. It handles the conversion according to the preferred type hint, either Number or String.
Converting to primitive with no hint
This code converts a Date object to its primitive value without specifying a type hint. The default hint will be applied based on the object type.
var toPrimitive = require('es-to-primitive');
var obj = new Date();
var primitiveValue = toPrimitive(obj);Converting to primitive with a hint of Number
This code converts a Date object to its primitive value with a type hint of Number, which means it will prefer the numeric value of the Date (timestamp).
var toPrimitive = require('es-to-primitive');
var obj = new Date();
var primitiveValue = toPrimitive(obj, Number);Converting to primitive with a hint of String
This code converts an object with both toString and valueOf methods to its primitive value with a type hint of String, which means it will prefer the string representation 'foo'.
var toPrimitive = require('es-to-primitive');
var obj = { toString: function() { return 'foo'; }, valueOf: function() { return 42; } };
var primitiveValue = toPrimitive(obj, String);The to-primitive package is another alternative that offers similar functionality to es-to-primitive. It aims to provide a reliable way to get the primitive value of objects but may have different internal implementations or API design.
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.
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);
Simply clone the repo, npm install, and run npm test
v1.3.0 - 2024-11-26
bb72efces-value-fixtures a912f7b510baf069ba1fd4ea66e6node/install instead of node/run; use codecov action 3c31937389567enpmignore to autogenerate an npmignore file 9f3aa76c60d7d8nyc on all tests; use tape runner 29cbb89auto-changelog ea744b2eslint, @ljharb/eslint-config, aud, function.prototype.name, has-symbols, object-inspect, object-is, tape e5c3c79a5a6f00@ljharb/eslint-config, es-value-fixtures, function.prototype.name, npmignore, object-inspect, object-is, tape 7941fd5eslint, @ljharb/eslint-config, aud, es-value-fixtures, foreach, object-inspect, tape eb1c79ceslint, @ljharb/eslint-config, function.prototype.name, object-inspect, safe-publish-latest, tape 249b42feslint, @ljharb/eslint-config, aud, function.prototype.name, object-inspect, object-is, tape d57d5e9003b62c75ee990eslint, @ljharb/eslint-config, tape, object-is; add safe-publish-latest ba5da7b6f7aec7eslint, @ljharb/eslint-config, aud, object-inspect, tape 3291fd5eslint, @ljharb/eslint-config, function.prototype.name, has-symbols, object-inspect 53007f269640dbeslint, @ljharb/eslint-config, object-is, tape; add aud c9d644efor-each instead of foreach e9117bb53cd375is-callable, is-date-object, is-symbol 8116c68Symbol.toPrimitive e6268efpull_request_target event da41c40is-callable, is-date-object 96fe13faud with npm audit 0b53154prepublishOnly script for npm 7+ 9d7d485is-callable 3c990b6is-callable 9bcfff2is-callable 1eb5478aud on prod deps 1fcd896is-symbol 7174a47funding fieldeslint, @ljharb/eslint-config, covert, replace, semver, tape, function.prototype.namesymbol types (#45)npx aud instead of nsp or npm audit with hoopsjscsis-callabletape, jscs, nsp, eslint, @ljharb/eslint-config, semver, object-inspect, replacenew Date(NaN) on node v6.0 and v6.1.node v10.11, v9.11, v8.12, v6.14, v4.9Symbol.toPrimitive supportis-callable, is-date-objecteslint, tape, semver, jscs, covert, nsp, @ljharb/eslint-confignode v5.3is-callable, is-date-objecteslint, tape, semver, jscs, covert, nsp, @ljharb/eslint-confignode v5.3FAQs
ECMAScript “ToPrimitive” algorithm. Provides ES5 and ES2015 versions.
The npm package es-to-primitive receives a total of 32,554,261 weekly downloads. As such, es-to-primitive popularity was classified as popular.
We found that es-to-primitive demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s Threat Research Team has uncovered 60 npm packages using post-install scripts to silently exfiltrate hostnames, IP addresses, DNS servers, and user directories to a Discord-controlled endpoint.
Security News
TypeScript Native Previews offers a 10x faster Go-based compiler, now available on npm for public testing with early editor and language support.
Research
Security News
Malicious npm packages targeting React, Vue, Vite, Node.js, and Quill remained undetected for two years while deploying destructive payloads.