Provides domain prefixed ES6 Maps. Can be used as registry for other components.

Downloads in past


0.0.178 years ago8 years agoMinified + gzip package size for domain-map in KB


domain-map provides domain prefixed ES6 Maps, and can be used as registry for other components.


Using npm:
$ npm install --save domain-map

How to use?

Normal usage with ES2015 modules:
import DomainMap from 'domain-map'
let registry = new DomainMap();

// Set value for key with domain prefix
registry.set('myDomain', 'someKey', 'value1');
registry.set('myDomain', 'otherKey', 'value2');

// Get value for domain key
registry.get('myDomain', 'someKey');
// Returns 'value1'

// You can provide default value, which will be used if key doesn't exists
registry.get('myDomain', 'randomKey', false);
// Returns 'false'

// Get list of keys
// Returns ["someKey", "otherKey"]

// Or whole domain
let items = registry.getDomain('myDomain');
items.forEach((key, value) => {
  // Iterate

// Clear whole domain

// Since key values are maps, you can actually save anything:
registry.set('properties', 'objectAsValue', {abc: false});
registry.set('properties', 'exampleFunction', (value) => { return value + 1; });

In some cases you want to store data for key which is actually an object. Normal ES6 Map object will return value for object only if key is exactly the same object you used when storing data:
// Normal maps
let map = new Map();

let myObjectKey = {entityId: 1};
let mySecondKey = {entityId: 1};

map.set(myObjectKey, {name: "Alice"});
// Will return {name: "Alice"}

// Will return null, since key objects are not same

Domain map allows you to use "deep object key comparison". Two objects are same if their values equals:
import DomainMap from 'domain-map'

let registry = new DomainMap({strictKeyMode: false});

let myObjectKey = {entityId: 1};
let mySecondKey = {entityId: 1};

registry.set('myDomain', myObjectKey, {name: 'Alice'});
registry.get('myDomain', mySecondKey, false);
// Will return {name: 'Alice'}

If you need just Map object with deep object key comparison, you can have one with static createCollection() method:
let collection = DomainMap.createCollection({strictKeyMode: false});


Run tests using npm:
$ npm run test