node/deps/npm/node_modules/lru-cache/lib/lru-cache.js
2012-09-10 09:11:54 -07:00

196 lines
4.5 KiB
JavaScript

;(function () { // closure for web browsers
if (module) {
module.exports = LRUCache
} else {
// just set the global for non-node platforms.
this.LRUCache = LRUCache
}
function hOP (obj, key) {
return Object.prototype.hasOwnProperty.call(obj, key)
}
function naiveLength () { return 1 }
function LRUCache (options) {
if (!(this instanceof LRUCache)) {
return new LRUCache(options)
}
var max
if (typeof options === 'number') {
max = options
options = {max: max}
}
max = options.max
if (!options) options = {}
var lengthCalculator = options.length || naiveLength
if (typeof lengthCalculator !== "function") {
lengthCalculator = naiveLength
}
if (!max || !(typeof max === "number") || max <= 0 ) {
max = Infinity
}
var maxAge = options.maxAge || null
var dispose = options.dispose
var cache = {} // hash of items by key
, lruList = {} // list of items in order of use recency
, lru = 0 // least recently used
, mru = 0 // most recently used
, length = 0 // number of items in the list
, itemCount = 0
// resize the cache when the max changes.
Object.defineProperty(this, "max",
{ set : function (mL) {
if (!mL || !(typeof mL === "number") || mL <= 0 ) mL = Infinity
max = mL
// if it gets above double max, trim right away.
// otherwise, do it whenever it's convenient.
if (length > max) trim()
}
, get : function () { return max }
, enumerable : true
})
// resize the cache when the lengthCalculator changes.
Object.defineProperty(this, "lengthCalculator",
{ set : function (lC) {
if (typeof lC !== "function") {
lengthCalculator = naiveLength
length = itemCount
Object.keys(cache).forEach(function (key) {
cache[key].length = 1
})
} else {
lengthCalculator = lC
length = 0
Object.keys(cache).forEach(function (key) {
cache[key].length = lengthCalculator(cache[key].value)
length += cache[key].length
})
}
if (length > max) trim()
}
, get : function () { return lengthCalculator }
, enumerable : true
})
Object.defineProperty(this, "length",
{ get : function () { return length }
, enumerable : true
})
Object.defineProperty(this, "itemCount",
{ get : function () { return itemCount }
, enumerable : true
})
this.reset = function () {
if (dispose) {
Object.keys(cache).forEach(function (k) {
dispose(k, cache[k].value)
})
}
cache = {}
lruList = {}
lru = 0
mru = 0
length = 0
itemCount = 0
}
// Provided for debugging/dev purposes only. No promises whatsoever that
// this API stays stable.
this.dump = function () {
return cache
}
this.set = function (key, value) {
if (hOP(cache, key)) {
// dispose of the old one before overwriting
if (dispose) dispose(key, cache[key].value)
if (maxAge) cache[key].now = Date.now()
cache[key].value = value
this.get(key)
return true
}
var hit = {
key:key,
value:value,
lu:mru++,
length:lengthCalculator(value),
now: (maxAge) ? Date.now() : 0
}
// oversized objects fall out of cache automatically.
if (hit.length > max) return false
length += hit.length
lruList[hit.lu] = cache[key] = hit
itemCount ++
if (length > max) trim()
return true
}
this.get = function (key) {
if (!hOP(cache, key)) return
var hit = cache[key]
if (maxAge && (Date.now() - hit.now > maxAge)) {
this.del(key)
return
}
delete lruList[hit.lu]
if (hit.lu === lru) lruWalk()
hit.lu = mru ++
lruList[hit.lu] = hit
return hit.value
}
this.del = function (key) {
if (!hOP(cache, key)) return
var hit = cache[key]
if (dispose) dispose(key, hit.value)
delete cache[key]
delete lruList[hit.lu]
if (hit.lu === lru) lruWalk()
length -= hit.length
itemCount --
}
function lruWalk () {
// lru has been deleted, hop up to the next hit.
for (var key in lruList) {
return key
}
}
function trim () {
if (length <= max) return
var prune = Object.keys(lruList)
for (var i = 0; i < prune.length && length > max; i ++) {
var hit = lruList[prune[i]]
if (dispose) dispose(hit.key, hit.value)
length -= hit.length
delete cache[ hit.key ]
delete lruList[prune[i]]
}
lruWalk()
}
}
})()