Request utilities for Mocha
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

request-mocha Build status

Request utilities for Mocha.

This was built as a repetitive test utility to request results and assert later on.

Getting Started

Install the module with: npm install request-mocha

// In your test suite
var request = require('request');
var httpUtils = require('request-mocha')(request);
describe('A server receiving a request', function () {

  // Make request and save results to `this.err`, `this.res`, and `this.body`'http://localhost:8080/');

  // Assert against mocha's `this` context
  it('responded with "Hello World!"', function () {
    expect(this.body).to.equal('Hello World!');


request-mocha provides a function, requestMocha, as its module.exports.


Create a set of utilities bound to a specific version of request.

This interface is necessary to prevent cross-version conflicts (e.g. jar problems)

  • request Request - request library to use for utility functions

requestMocha returns an object which we will refer to as httpUtils.

Make a request to a server via request inside of a mocha before/setup block.

  • options Object - Parameters to pass through to request's request function

Results will be saved to mocha's this context. The same this context is shared between all mocha before, beforeEach, after, afterEach, and it invocations.

  • this.err Error|null - Error if one occurred while making the request (e.g. ECONNREFUSED)
  • this.res Response - Response from the server
  • this.body String - Response body from the server (alias for res.body)


Invoke request/save mechanism without before/setup wrapper.

The parameters are the same as

The returned value is a function with a signature of (done). When invoked, it will write to this.err, this.res, and this.body as done in

It is expected that you invoke the returned function via a .call or .apply to an asynchronous before context with its callback. This is practical when there is data locked into a this context that needs to be used for a request.

// Prepare some `this` data
before(function () {
  this.credentials = {
    username: 'todd',
    password: 'keyboardcat'

// In an asynchronous `before` block
before(function (done) {
  // Prepare the save call
    method: 'POST',
    url: 'http://localhost:8080/login',
    form: this.credentials
  // Invoke on the current context with the current callback
  }).call(this, done);

The alternative is to use var's outside of before blocks. Unfortunately, those cannot be re-used while a before function can be.


Making a POST request inside of tests{
  method: 'POST',
  url: 'http://localhost:8080/',
  form: {
    my: 'data'


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint via grunt and test via npm test.


Copyright (c) 2014 Uber

Licensed under the MIT license.