global-cache ^{[![Version Badge][2]][1]}

[![Build Status][3]][4]
[![dependency status][5]][6]
[![dev dependency status][7]][8]
[![License][license-image]][license-url]
[![Downloads][downloads-image]][downloads-url]

[![npm badge][11]][1]

[![browser support][9]][10]

Sometimes you have to do horrible things, like use the global object to share a singleton. Abstract that away, with this!

This attaches a cache to the global object. It attempts to make it as undiscoverable as possible:
- uses Symbols if available
- if not, uses a string key that is not a valid identifier, so as not to show up in dot-notation browser autocomplete
- makes it non-enumerable if property descriptors are supported

Keys are required to be strings or symbols.

Example

``js
var cache = require('global-cache');
var assert = require('assert');

var value = {};
assert(cache.get(key) === undefined);
assert(cache.has(key) === false);

cache.set(key, value);
assert(cache.get(key) === value);
assert(cache.has(key) === true);

cache.delete(key);
assert(cache.get(key) === undefined);
assert(cache.has(key) === false);
`

Tests


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

[1]: https://npmjs.org/package/global-cache
[2]: http://versionbadg.es/ljharb/global-cache.svg
[3]: https://travis-ci.org/ljharb/global-cache.svg
[4]: https://travis-ci.org/ljharb/global-cache
[5]: https://david-dm.org/ljharb/global-cache.svg
[6]: https://david-dm.org/ljharb/global-cache
[7]: https://david-dm.org/ljharb/global-cache/dev-status.svg
[8]: https://david-dm.org/ljharb/global-cache#info=devDependencies
[9]: https://ci.testling.com/ljharb/global-cache.png
[10]: https://ci.testling.com/ljharb/global-cache
[11]: https://nodei.co/npm/global-cache.png?downloads=true&stars=true
[license-image]: http://img.shields.io/npm/l/global-cache.svg
[license-url]: LICENSE
[downloads-image]: http://img.shields.io/npm/dm/global-cache.svg
[downloads-url]: http://npm-stat.com/charts.html?package=global-cache