Getting started with JavaScript

Getting started with JavaScript and the CouchDB API.

Simple Wrapper

There is a simple JavaScript wrapper around CouchDB included in the distribution. When you install the server it is installed as [WWW] http://localhost:5984/_utils/script/couch.js. You can see examples of its use in couch_tests.js:

 var nc = {_id:"NC", cities:["Charlotte", "Raleigh"]};
 var ma = {_id:"MA", cities:["Boston", "Lowell", "Worcester", "Cambridge", "Springfield"]};
 var fl = {_id:"FL", cities:["Miami", "Tampa", "Orlando", "Springfield"]};;;;


 var nc_cities ='NC').cities;

Obviously the couch.js API is by no means final since CouchDB itself is still in flux.

Rolling Your Own

CouchDB speaks JSON. JSON means JavaScript Object Notation. CouchDB also speaks Plain Old HTTP, so getting going with JavaScript is a walk in the park with the XMLHttpRequest object:

// instantiate a new XMLHttpRequest object
var req = new XMLHttpRequest()
// Open a GET request to "/all_dbs""GET", "/_all_dbs")
// Send nothing as the request body
// Get the response
["some_database", "another_database"]

Going from here is just a matter using the normal CouchDB HttpRestApi to get what you want.

There is numerous javascript libraries out there that wraps up both XMLHttpRequest and JSON in possibly nicer APIs, including:

last edited 2008-11-01 23:47:22 by MartinCzura