Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

Added getDocs #45

Open
wants to merge 1 commit into from

1 participant

Daniel
Daniel

Hi!

I added support for fetching multiple documents with a single request.

This was partially supported by allDocs, but fetching by keys-array should be done with POST according to the documentation.

Kind Regards,
Daniel

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on Sep 12, 2012
  1. Daniel

    Added getDocs.

    0xDB authored
This page is out of date. Refresh to see the latest.
Showing with 40 additions and 0 deletions.
  1. +16 −0 README.md
  2. +24 −0 lib/couchdb.js
16 README.md
View
@@ -207,6 +207,22 @@ Wrapper for [DELETE /db-name](http://wiki.apache.org/couchdb/HTTP_database_API#D
Wrapper for [GET /db-name/doc-id\[?rev=\]\[&attachments=\]](http://wiki.apache.org/couchdb/HTTP_Document_API#GET). Fetches a document with a given `id` and optional `rev` and/or `attachments` from the database.
+### db.getDocs(keys/startkey, [endkey])
+
+Fetches multiple documents using [/\_all\_docs](http://wiki.apache.org/couchdb/HTTP_Bulk_Document_API#Fetch_Multiple_Documents_With_a_Single_Request).
+
+Example:
+
+ db.getDocs(['aa', 'bb', 'cc'], function (er, r) {
+ if (er) throw new Error(JSON.stringify(er));
+ // r => {"total_rows":10,"offset":2,"rows":[{...}]}
+ });
+
+ db.getDocs('aa', 'cc', function (er, r) {
+ if (er) throw new Error(JSON.stringify(er));
+ // r => {"total_rows":10,"offset":2,"rows":[{...}]}
+ });
+
### db.saveDoc(id, doc)
Wrapper for [PUT /db-name/doc-id](http://wiki.apache.org/couchdb/HTTP_Document_API#PUT). Saves a json `doc` with a given `id`.
24 lib/couchdb.js
View
@@ -470,6 +470,30 @@ Db.prototype.getDoc = function(id, rev, attachments, cb) {
return this.request(request, cb);
};
+Db.prototype.getDocs = function (startkey, endkey, cb) {
+ // if startkey is an array of keys use POST to get docs
+ if (Array.isArray(startkey) && typeof(endkey) === 'function') {
+ cb = endkey;
+ return this.request({
+ path: '/_all_docs',
+ query: {include_docs: true},
+ data: {keys:startkey},
+ method: 'POST'
+ }, cb);
+ } else {
+ // if startkey and endkey are provided use default GET
+ var query = {
+ include_docs: true,
+ startkey: startkey,
+ endkey: endkey
+ }
+ return this.request({
+ path: '/_all_docs',
+ query: query
+ }, cb);
+ }
+};
+
Db.prototype.saveDoc = function(id, doc, cb) {
if (typeof id == 'object') {
cb = doc;
Something went wrong with that request. Please try again.