wemoloh / insort

JavaScript (ES6) Map, Set, and Object subclasses that efficiently maintain a sorted iteration order.

insort

JavaScript (ES6) Map, Set, and Object subclasses that efficiently maintain a sorted iteration order.

Usage

let {SortedMap, SortedSet, SortedObject} = require('insort');

// compare function (defaults to localeCompare)
let cmp = (a, b) => a - b;

let m = new SortedMap([[42, 'foo'], [99, 'bar'], [0, 'quux']], cmp);
m.set(59, 'spam');
for (let [key, val] of m) {
  console.log(key, val);
}
// 0 'quux'
// 42 'foo'
// 59 'spam'
// 99 'bar'

let s = new SortedSet([42, 99, 0], cmp);
s.add(59);
for (let key of s) {
  console.log(key);
}
// 0
// 42
// 59
// 99

let o = new SortedObject({foo: 42, bar: 99, quux: 0});
o.baz = -8;
for (let key in o) {
  console.log(key, o[key]);
}
// bar 99
// baz -8
// foo 42
// quux 0

Requirements

• ES6

Features

• Simple and small
• Uses standard APIs; just drop into existing Map-, Set-, or Object-based code
• Space efficient (adds an extra O(n) sorted Array of key references)
• Time efficient (O(1) find and replace, O(log(n)) insert and delete)

Caveats

• This works fine for a few thousand entries, but for larger datasets you probably want something fancier, such as a skip list.