Add db.getMany(keys)

Ref Level/community#101

Author: vweevers

README.md

@@ -208,7 +208,7 @@ If no callback is passed, a promise is returned.
 
 ### `db.get(key[, options][, callback])`
 
-<code>get()</code> is the primary method for fetching data from the store. The `key` can be of any type. If it doesn't exist in the store then the callback or promise will receive an error. A not-found err object will be of type `'NotFoundError'` so you can `err.type == 'NotFoundError'` or you can perform a truthy test on the property `err.notFound`.
+Get a value from the store by `key`. The `key` can be of any type. If it doesn't exist in the store then the callback or promise will receive an error. A not-found err object will be of type `'NotFoundError'` so you can `err.type == 'NotFoundError'` or you can perform a truthy test on the property `err.notFound`.
 
 ```js
 db.get('foo', function (err, value) {
@@ -225,10 +225,20 @@ db.get('foo', function (err, value) {
 })
 ```
 
-`options` is passed on to the underlying store.
+The optional `options` object is passed on to the underlying store.
 
 If no callback is passed, a promise is returned.
 
+<a name="get_many"></a>
+
+### `db.getMany(keys[, options][, callback])`
+
+Get multiple values from the store by an array of `keys`. The optional `options` object is passed on to the underlying store.
+
+The `callback` function will be called with an `Error` if the operation failed for any reason. If successful the first argument will be `null` and the second argument will be an array of values with the same order as `keys`. If a key was not found, the relevant value will be `undefined`.
+
+If no callback is provided, a promise is returned.
+
 <a name="del"></a>
 
 ### `db.del(key[, options][, callback])`

lib/levelup.js

@@ -185,6 +185,10 @@ LevelUP.prototype.get = function (key, options, callback) {
   return callback.promise
 }
 
+LevelUP.prototype.getMany = function (keys, options, callback) {
+  return this.db.getMany(keys, options, callback)
+}
+
 LevelUP.prototype.put = function (key, value, options, callback) {
   callback = getCallback(options, callback)
   callback = catering.fromCallback(callback)

test/self.js

@@ -34,7 +34,6 @@ suite({
 // TODO to make this pass:
 // - Have abstract-leveldown use level-errors
 // - Perform type checks in same order (e.g. check key before callback)
-// - Add db.isClosed(), isOpen() to abstract-leveldown
 suite({
   test: noop,
   factory: function (options) {