unbox-primitive

unbox-primitive

Unbox a boxed JS primitive value. This module works cross-realm/iframe, does not depend on instanceof or mutable properties, and works despite ES6 Symbol.toStringTag.

Example

var unboxPrimitive = require('unbox-primitive');
var assert = require('assert');

assert.equal(unboxPrimitive(new Boolean(false)), false);
assert.equal(unboxPrimitive(new String('f')), 'f');
assert.equal(unboxPrimitive(new Number(42)), 42);
const s = Symbol();
assert.equal(unboxPrimitive(Object(s)), s);
assert.equal(unboxPrimitive(new BigInt(42)), 42n);

// any primitive, or non-boxed-primitive object, will throw

Tests

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

Changelog

v1.1.0 - 2024-12-15

Commits

• [meta] use npmignore to autogenerate an npmignore file 348a5ad
• [New] add types a324230
• [Tests] use es-value-fixtures a321ae5
• [actions] split out node 10-20, and 20+ 04a0e0d
• [Dev Deps] update @ljharb/eslint-config, auto-changelog, npmignore, object-inspect, object-is, tape 7fff971
• [actions] update rebase action 91d6807
• [Deps] update call-bind, has-symbols, which-boxed-primitive f8b6597
• [Dev Deps] update aud, object-inspect, tape b3362a1
• [Refactor] use call-bound directly e29ff5f
• [meta] add missing engines.node d3420bc
• [Tests] replace aud with npm audit 5e6a6d0
• [Deps] update which-boxed-primitive 0ff873d
• [Dev Deps] update aud dd0e373
• [Dev Deps] add missing peer dep 4f79b24