Add peek()

README.md

@@ -55,6 +55,12 @@ There are a few basic things that all caches support.
     If `recordStats` is set to `false`, then the get won't increase any metrics
     or affect any stats of a bounded cache.
 
+* `cache.peek(key): mixed|null`
+
+    Same as `getIfPresent(key, false)`. Will return the cached value, but never
+		load a value if it does not exist and not affect any metrics or stats of
+		the cache.
+
 * `cache.has(key): boolean`
 
     Check if the given key exists in the cache. The key can be either a

cache/base.js

@@ -17,6 +17,10 @@ module.exports = class BaseCache {
 		throwError();
 	}
 
+	peek(key) {
+		return this.getIfPresent(key, false);
+	}
+
 	delete(key) {
 		throwError();
 	}

test/base.test.js

@@ -22,6 +22,11 @@ describe('BaseCache', function() {
 		expect(() => cache.getIfPresent('key')).to.throw();
 	});
 
+	it('peek throws', function() {
+		const cache = new BaseCache();
+		expect(() => cache.peek('key')).to.throw();
+	});
+
 	it('delete throws', function() {
 		const cache = new BaseCache();
 		expect(() => cache.delete('key')).to.throw();

test/bounded.test.js

@@ -16,6 +16,7 @@ describe('BoundedCache', function() {
 
 		expect(cache.has('key')).to.equal(true);
 		expect(cache.get('key')).to.equal('value');
+		expect(cache.peek('key')).to.equal('value');
 	});
 
 	it('Get non-existent value in cache', function() {

test/metrics.test.js

@@ -44,4 +44,14 @@ describe('MetricsCache', function() {
 		expect(cache.metrics.misses).to.equal(0);
 		expect(cache.metrics.hitRate).to.equal(1);
 	});
+
+	it('Peek without recording stats', function() {
+		const cache = newCache();
+
+		expect(cache.peek('key')).to.equal(null);
+
+		expect(cache.metrics.hits).to.equal(0);
+		expect(cache.metrics.misses).to.equal(0);
+		expect(cache.metrics.hitRate).to.equal(1);
+	});
 });