node package manager


Node Fakeweb

A simple tool that will intercept requests made via http(s).request and mikeal's request module and respond with dummy data.

This version requires node v4 or higher, as it makes use of various bits of ES6 functionality. The 0.2.0 version of Fakeweb is compatible with v0.x releases of node, and should be used instead for older applications.

Heavily inspired by:


npm install --save-dev node-fakeweb

Basic Example

const request = require('request');
const fakeweb = require('node-fakeweb');
fakeweb.allowNetConnect = false;
fakeweb.registerUri({uri: '', body: 'Hello!'});
request.get({uri: ''}, (err, resp, body) => {

This will output:

[ctide ~]:~$ node test/test.js

Supported Functionality

This will intercept requests made using request or by using http.request and https.request. Other libraries that internally use those should be intercepted as well, but there's no guarantees.


const fakeweb = require('node-fakeweb');
fakeweb.allowNetConnect = false; // default = true

Setting this value to false will cause fakeweb to throw an exception for any web request that's made that isn't registered as one to intercept. Helpful to ensure that you aren't missing any web requests.

const fakeweb = require('node-fakeweb');
fakeweb.allowLocalConnect = false; // default = true

By default, fakeweb will allow requests that go to localhost or to pass through. Setting this to false will ensure that it will throw exceptions for these as well.

const fakeweb = require('node-fakeweb');
fakeweb.ignoreUri({uri: ''});

If you have allowNetConnect set to false, ignoring a URI will cause fakeweb to pass through requests to that URI as normla.

Registering URIs

registerUri accepts an object that contains the various options for intercepting a request.

Accepted options:

  • uri: This can either be an exact URL or a regex that will be compared against all requests.
  • method: Defaults to 'ANY', but otherwise will only match requests that have the method specified when registering the URI.
  • file: This will respond with the contents of a file as a string
  • binaryFile: This will respond with the contents of a file, but will read it in as a binary file instead of a string
  • statusCode: Status code can either be a number or an array. If given an array, fakeweb will iterate over the status codes for subsequent responses that match the uri.
  • headers: An object that contains the various headers that should be sent to the client.
  • contentType: Sets the content type of the response.
  • body: This can accept either a string or a function. If given a string, that will be the body of the response. When given a function, that function will be called and the return value of that function will be set as the body of the response.
  • exception: true will cause fakeweb to throw an ECONNREFUSED exception instead of handling the request. Useful for testing failure cases where the endpoint is unreachable.


A spy will be returned from registering a URI that can be used to verify that a request has been made. It will also contain a counter that will be incremented for each request that's been made.

const fakeweb = require('node-fakeweb');
let googleSpy = fakeweb.registerUri({uri: ''});
// googleSpy == { used: false, useCount: 0 }
request.get('', function() {});
// googleSpy will now look like:
// { used: true, useCount: 1 }

It can also trap the data POSTed to the url, and include that in the spy:

let fakeweb = require('node-fakeweb');
let googleSpy = fakeweb.registerUri({uri: ''});
// googleSpy == { used: false, useCount: 0 }{uri: '', body: 'hello!'}, function() {});
// googleSpy will now look like:
// { used: true, useCount: 1, body: 'hello!', form: undefined }


Please make sure your pull request contains tests and passes linting (npm run lint, npm test).