This article is part of the article series "Node.JS Modules You Should Know About."
<- previous article next article ->
node logo

Hey everyone! This is the fourth post in my new node.js modules you should know about article series.

The first post was about dnode - the freestyle rpc library for node, the second was about optimist - the lightweight options parser for node, the third was about lazy - lazy lists for node.

This time I'll introduce you to a very awesome module called request by Mikeal Rogers. Request is the swiss army knife of HTTP streaming.

Check this out:

var fs = require('fs')
var request = require('request');


Pow! You just streamed the response of HTTP request to into doodle.png local file!

Here is more awesome stuff:

var fs = require('fs')
var request = require('request');


Pow! It streamed your local file file.json to as HTTP PUT request!

var request = require('request');


Pow! This just streamed a HTTP GET from to HTTP PUT to

At Browserling we use this module for streaming data to and from couchdb. Here is an example that saves a JSON document at mikeal's test couchdb:

var request = require('request')
var rand = Math.floor(Math.random()*100000000).toString()

  method: 'PUT',
  uri: '' + rand,
  multipart: [
      'content-type': 'application/json',
      'body': JSON.stringify({
        foo: 'bar',
        _attachments: {
          'message.txt': {
            follows: true,
            length: 18,
            'content_type': 'text/plain'
    { body: 'I am an attachment' }
}, function (error, response, body) {
  if(response.statusCode == 201){
    console.log('document saved as:'+ rand);
  } else {
    console.log('error: '+ response.statusCode);

Install it via npm, as always:

npm install request

Sponsor this blog series!

Doing a node.js company and want your ad to appear in the series? The ad will go out to 14,000 rss subscribers, 7,000 email subscribers, and it will get viewed by thousands of my blog visitors! Email me and we'll set it up!

See ya!

If you love these articles, subscribe to my blog for more, follow me on Twitter to find about my adventures, and watch me produce code on GitHub!

This article is part of the article series "Node.JS Modules You Should Know About."
<- previous article next article ->


December 06, 2011, 18:09

Thanks. This was really helpful. Keep it coming. :-)

December 06, 2011, 21:42

Every day for the next month or two!

Wael Permalink
December 06, 2011, 19:42

Is requre a keyword in Node js?

December 06, 2011, 21:42

It's just a function, it's not a keyword. You can redefine it.

pkrumins$ node
> typeof require
> require = function (x) { console.log(x) }
> require('meow')
nisc Permalink
December 06, 2011, 20:09

More node posts! Yay! Everyone has had enough time to learn sed, AWK and Perl by now.

December 06, 2011, 21:43

Yeah! I am done with sed, awk and perl. Mastered it all, so should have all my readers. :)

December 06, 2011, 22:27

I think the previous comment refers to the typo in require, and namely requre

December 06, 2011, 23:04

Oops, you're right. I just noticed that. Fixed now!

voldyman Permalink
December 07, 2011, 15:05

We have, my master.... :)

nisc Permalink
December 06, 2011, 20:12

I'm not saying that I dislike your other posts, it's just that this stuff is more interesting ;-)

December 06, 2011, 21:43

I have blogged it all about sed, awk and perl. Nothing left. :)

Simon Permalink
December 06, 2011, 20:29

@Wael - yes, it's a built-in function for importing a module.

Antony Permalink
December 06, 2011, 20:53

Your "pow!" really encourages people to do random voice over, and not focus much on your NodeJS article. Good article though. Thanks for sharing.

December 06, 2011, 21:44


Nek Permalink
December 07, 2011, 04:44

Thanks a lot! Very useful.
Looks much simpler than "http"/"https".

January 10, 2012, 13:37

Pow! Good post Peter. The 'fs' method 'readStream' throws this error - reObject #


has no method 'readStream'. When I took a look at the node.js documentation I noticed that that the method starts with capital letter 'R' - 'ReadStream'. Thank you for this awesome series.

Leave a new comment

(why do I need your e-mail?)

(Your twitter handle, if you have one.)

Type the word "browser_286": (just to make sure you're a human)

Please preview the comment before submitting to make sure it's OK.