mock-res

Mocks node.js http.ServerResponse (a response). See also mock-req.

Being a readable/writable stream, you can pipe the response body to and from it.

Usage

See test.js for further usage.

var MockRes = require('mock-res');

// Basic usage
var res = new MockRes();

// Supply a callback to be called after res.end() is called
var res = new MockRes(function onEnd() {
    console.log('Response sent');
});

// Listen for stream events
res.on('error', function (err) {
    // If not listened for, the 'error' event will throw,
    // as is true for any stream.
});
res.on('finish', function () {
    console.log('Finished writing response');
});

// Read status code
res.statusCode; // 200 by default

// Read body as string
res._getString(); // 'I am a chicken';

// Read body as parsed JSON
res._getJSON(); // { chicken: true }

// Pipe body somewhere
res.pipe(fs.createWriteStream('/tmp/yo'));

Example test case

var assert = require('assert');
var list = require('./list-handler');
var MockRes = require('mock-res');

function test(done) {
    /* Arrange */

    // Use `mock-req` for a better mock
    var req = {
        method: 'GET',
        url: '/foos'
    }

    var res = new MockRes(onEnd);

    /* Act */
    list(req, res);

    /* Assert */
    function onEnd() {
        // NOTE `this` === `res`

        assert.equal(this.statusCode, 200);
        assert.equal(this._getString(), '[{"id":0},{"id":1}]');
        assert.deepEqual(this._getJSON(), [{id: 0 }, {id: 1 }]);
        assert.deepEqual(this.getHeader('set-cookie'), ['a=1', 'b=2']);

        res.pipe(process.stdout); // `res` is just a readable stream here

        done(); // this is an async test
    }
}

Methods

• All readable/writable stream methods.
• writeHead(statusCode, [reasonPhrase], [headers]) Sets the response status code, status message, and headers. See also the http.ServerResponse documentation.
• setHeader(), getHeader(), getHeaders(), removeHeader()
• _getString() Reads the body as a string, from the internal stream buffer.
• _getJSON() Reads the body as a parsed JSON object, from the internal stream buffer.