couchdb-commonjs

KO | EN

gitlite — search

#php #javascript #python #java #hacktoberfest #c #nodejs #shell #arduino #c-sharp #ruby #csharp

couchdb-commonjs

★ 32 Open GitHub ↗

CommonJS CouchDB Client for use in browser, node.js, and narwhal

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CouchDB Client

CouchDB-CommonJS is a promise-based CouchDB client.  It can be used in the browser or on the server
via Node.js.

## Example Usage in Node.js

Create a module named hello-couch.js and add the following code:

var couchdb = require('couchdb');
    var client  = couchdb.createClient(5984, 'localhost');
    var db      = client.db('helloCouch');

var doc = { _id: 'helloCouch', text: 'Hello CouchDB!' };

db.saveDoc(doc).then(function() {
    	console.log('document saved!');

db.openDoc('helloCouch').then(function(doc) {
    		console.log('retrieved document!');
    		console.log(JSON.stringify(doc));
    	});
    });

Before executing this module, create a database in your CouchDB named `helloCouch`
using [futon](http://localhost:5984/_utils).

This program creates a document in the CouchDB Database *helloCouch*.  Next,
it saves a document to the database with a key of *helloCouch* and a text
property.  Then, it retrieves the document from the database and prints the
contents of the document to the console.

## Promises

Methods on `CouchClient` and `Database` return [promises](http://wiki.commonjs.org/wiki/Promises).
The promises are [Promises/A](http://wiki.commonjs.org/wiki/Promises/A) compliant. You may be familiar
with [promises in jQuery](http://www.erichynds.com/jquery/using-deferreds-in-jquery/) as they have recently 
been added to make Ajax calls cleaner.

couchdb-commonjs

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README