root 3bf41bf355 update 1 year ago
..
test 3bf41bf355 update 1 year ago
.lint 3bf41bf355 update 1 year ago
.npmignore 3bf41bf355 update 1 year ago
.travis.yml 3bf41bf355 update 1 year ago
CHANGES 3bf41bf355 update 1 year ago
LICENSE 3bf41bf355 update 1 year ago
README.md 3bf41bf355 update 1 year ago
implement.js 3bf41bf355 update 1 year ago
index.js 3bf41bf355 update 1 year ago
is-implemented.js 3bf41bf355 update 1 year ago
is-native-implemented.js 3bf41bf355 update 1 year ago
is-weak-map.js 3bf41bf355 update 1 year ago
package.json 3bf41bf355 update 1 year ago
polyfill.js 3bf41bf355 update 1 year ago
valid-weak-map.js 3bf41bf355 update 1 year ago

README.md

es6-weak-map

WeakMap collection as specified in ECMAScript6

Roughly inspired by Mark Miller's and Kris Kowal's WeakMap implementation.

Differences are:

  • Assumes compliant ES5 environment (no weird ES3 workarounds or hacks)
  • Well modularized CJS style
  • Based on one solution.

Limitations

  • Will fail on non extensible objects provided as keys

Installation

$ npm install es6-weak-map

To port it to Browser or any other (non CJS) environment, use your favorite CJS bundler. No favorite yet? Try: Browserify, Webmake or Webpack

Usage

If you want to make sure your environment implements WeakMap, do:

require('es6-weak-map/implement');

If you'd like to use native version when it exists and fallback to polyfill if it doesn't, but without implementing WeakMap on global scope, do:

var WeakMap = require('es6-weak-map');

If you strictly want to use polyfill even if native WeakMap exists, do:

var WeakMap = require('es6-weak-map/polyfill');

API

Best is to refer to specification. Still if you want quick look, follow example:

var WeakMap = require('es6-weak-map');

var map = new WeakMap();
var obj = {};

map.set(obj, 'foo'); // map
map.get(obj);        // 'foo'
map.has(obj);        // true
map.delete(obj);     // true
map.get(obj);        // undefined
map.has(obj);        // false
map.set(obj, 'bar'); // map
map.has(obj);        // false

Tests Build Status

$ npm test