e 01bbba5f61 ts 10 months ago
..
.github 01bbba5f61 ts 10 months ago
test 01bbba5f61 ts 10 months ago
.editorconfig 01bbba5f61 ts 10 months ago
.eslintrc 01bbba5f61 ts 10 months ago
.nycrc 01bbba5f61 ts 10 months ago
CHANGELOG.md 01bbba5f61 ts 10 months ago
LICENSE 01bbba5f61 ts 10 months ago
README.md 01bbba5f61 ts 10 months ago
index.d.ts 01bbba5f61 ts 10 months ago
index.js 01bbba5f61 ts 10 months ago
package.json 01bbba5f61 ts 10 months ago
tsconfig.json 01bbba5f61 ts 10 months ago

README.md

side-channel-map Version Badge

github actions coverage License Downloads

npm badge

Store information about any JS value in a side channel, using a Map.

Warning: if the key is an object, this implementation will leak memory until you delete it. Use side-channel for the best available strategy.

Getting started

npm install --save side-channel-map

Usage/Examples

const assert = require('assert');
const getSideChannelMap = require('side-channel-map');

const channel = getSideChannelMap();

const key = {};
assert.equal(channel.has(key), false);
assert.throws(() => channel.assert(key), TypeError);

channel.set(key, 42);

channel.assert(key); // does not throw
assert.equal(channel.has(key), true);
assert.equal(channel.get(key), 42);

channel.delete(key);
assert.equal(channel.has(key), false);
assert.throws(() => channel.assert(key), TypeError);

Tests

Clone the repo, npm install, and run npm test