webtap

A TAP wrapper for testing webservers

Usage

Write a test for your webserver:

// test/test.js
 
var webtap = require('webtap');
 
var test = webtap(function (req, res) {
  res.statusCode = 404;
  res.end('file not found');
});
 
test('GET /', function (t, res) {
  t.equal(res.statusCode, 404);
  t.body('file not found');
});
 
test('custom name', 'POST /', function (t, res) {
  t.equal(res.statusCode, 404);
  t.body('file not found');
});

Then execute it:

$ tap test/test.js
TAP version 13
# GET / 
ok 1 status code 404
ok 2 friendly message
# custom name 
ok 3 status code 404
ok 4 friendly message
 
1..4
# tests 4 
# pass  4 
 
# ok 

API

var test = webtap(server)

Return the test function. server can either be a request handler function (e.g. what express exports) or a server from http.createServer().

test([name, ]method[, path], cb)

Fire a request with method on path to the given server can call cb with:

• t, the TAP test object
• res, the response object from http.request()

The test name is either name or a combination of method and path, like GET /.

path can be left out if method already contains the path, like:

test('name', 'GET /', cb);
test('GET /', cb);

t.body(str[, msg])

t is augmented by a body method that buffers the request body into a string, compares it with str and then calls t.end() to finish the test.

If str is not a string but any other JavaScript object, the response will be parsed as JSON and compared to str.

t.*

See the tap documentation.

Installation

With npm do

$ npm install webtap

and

$ npm install -g tap

License

(MIT)