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.