How to test Node.js: Mocking HTTP request

How to test Node.js: Mocking HTTP request

How to test Node.js: Mocking HTTP request ... Writing tests for an application that relies on external services, say, a RESTful API, is challenging. ✈️✈️✈️✈️✈️

More often than not, an external resource may require authentication, authorization or may have a rate limiting.Hitting an endpoint for a service hosted in a service like AWS as part of testing would also incur extra charges.

This quickly goes out of hand when you are running tests a couple of times a day as a team, as well as part of continous integration. Nock, a HTTP mocking and expectations library for Node.js can be used to avoid this.


Table of Contents

  • Objectives
  • Setting Up The Project
  • Creating A Node.js App To Test
  • Testing: The Wrong Way
  • Testing: The Right Way
  • Conclusion

By the end of this post, we will have achieved the following.

  • Written a simple Node.js application that makes a HTTP request to an external endpoint.
  • Write tests for the application
  • Mock the requests in the test.

Setting Up The Project

To get started, create a simple Node.js application by creating an empty folder and running npm init.

mkdir nock-tests
cd nock-tests
npm init

Installing the packages

Next, we will install the following packages for our application and testing environment.

  • Axios - A Promise based HTTP client for the browser and node.js
  • Mocha - A popular Node.js testing framework.
  • Chai - A BDD / TDD assertion library for Node.js
  • Nock - A HTTP mocking and expectations library for Node.js
npm install --save axios
npm install --save-dev mocha chai nock

Setting up tests

Our tests will live inside a test directory, Go ahead and create a test directory and create our first test.

mkdir test
touch test/index.test.js

Our first test should be pretty straightforward. Assert that true is, well, true.


const expect = require('chai').expect;

describe('First test', () => { it('Should assert true to be true', () => { expect(true); }); });

To run our test, we could run the mocha command from our node_modules but that can get annoying. We are instead going to add it as an npm script.


  "name": "nock-tests",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "node_modules/.bin/mocha"
  "author": "",
  "license": "ISC",
  "dependencies": {
    "axios": "^0.16.2"
  "devDependencies": {
    "chai": "^4.0.2",
    "mocha": "^3.4.2",
    "nock": "^9.0.13"

At this point, running npm test on your command-line should give you the following result.

$ npm test > [email protected] test /Users/username/projects/nock-tests > mocha First test ✓ Should assert true to be true 1 passing (15ms)

We obviously don't have any tests making requests, or a useful request for that matter, but we will be changing that.

Creating A Node.js App To Test

Let's go ahead and write a simple function that makes a HTTP request to the Github API to get a user by username. Go ahead and create an index.js file in the root and add the following code.


const axios = require('axios');

module.exports = { getUser(username) { return axios .get(${username}) .then(res => .catch(error => console.log(error)); } };

Testing: The Wrong Way

Our test will assert that the request made returns an object with specific details. Replace the truthy test we created earlier with the following test for our code.

const expect = require('chai').expect;

const getUser = require('../index').getUser;

describe('Get User tests', () => { it('Get a user by username', () => { return getUser('octocat') .then(response => { //expect an object back expect(typeof response).to.equal('object');

    //Test result of name, company and location for the response
    expect('The Octocat')
    expect(response.location).to.equal('San Francisco')

}); });

Let's break down the test.

  • We import the getUser method from /index.js.
  • We then call the function and assert that we get an object back and that the user's name, company and location match.

This should pass on running the test by actually making a request to the Github API. Let's fix this!

Testing: The Right Way

Nock works by overriding Node's http.request function. Also, it overrides http.ClientRequest too to cover for modules that use it directly.

With Nock, you can specify the HTTP endpoint to mock as well as the response expected from the request in JSON format. The whole idea behind this is that we are not testing the Github API, we are testing our own application. For this reason, we make the assumption that the Github API's response is predictable.

To mock the request, we will import nock into our test and add the request and expected response in the beforeEach method.


const expect = require('chai').expect;
const nock = require('nock');

const getUser = require('../index').getUser; const response = require('./response');

describe('Get User tests', () => { beforeEach(() => { nock('') .get('/users/octocat') .reply(200, response); });

it('Get a user by username', () => { return getUser('octocat') .then(response => { //expect an object back expect(typeof response).to.equal('object');

    //Test result of name, company and location for the response
    expect('The Octocat')
    expect(response.location).to.equal('San Francisco')

}); });

The expected response is defined as an export in a separate file.


module.exports = { login: 'octocat',
  id: 583231,
  avatar_url: '',
  gravatar_id: '',
  url: '',
  html_url: '',
  followers_url: '',
  following_url: '{/other_user}',
  gists_url: '{/gist_id}',
  starred_url: '{/owner}{/repo}',
  subscriptions_url: '',
  organizations_url: '',
  repos_url: '',
  events_url: '{/privacy}',
  received_events_url: '',
  type: 'User',
  site_admin: false,
  name: 'The Octocat',
  company: 'GitHub',
  blog: '',
  location: 'San Francisco',
  email: null,
  hireable: null,
  bio: null,
  public_repos: 7,
  public_gists: 8,
  followers: 1840,
  following: 6,
  created_at: '2011-01-25T18:44:36Z',
  updated_at: '2017-07-06T21:26:58Z' };

To test that this is the actual response expected in the test, try editing one of the fields in the response object and run the test again. The tests should fail.

In my case, I will be changing the name value to Scotch. You should get the error below.


We have only scratched the surface on what you can do with nock. It has a very detailed documentation on how to use it and it is worth exploring. For instance, If you are writing tests that involve error handling, you could mock error responses with an error message.

   .replyWithError('something awful happened');

Happy testing!


Thanks for reading :heart: If you liked this post, share it with all of your programming buddies! Follow me on Facebook | Twitter

Learn More

☞ The Complete Node.js Developer Course (3rd Edition)

☞ Angular & NodeJS - The MEAN Stack Guide

☞ NodeJS - The Complete Guide (incl. MVC, REST APIs, GraphQL)

☞ Docker for Node.js Projects From a Docker Captain

☞ Intro To MySQL With Node.js - Learn To Use MySQL with Node!

☞ Node.js Absolute Beginners Guide - Learn Node From Scratch

☞ React Node FullStack - Social Network from Scratch to Deploy

☞ Selenium WebDriver - JavaScript nodeJS webdriver IO & more!

☞ Complete Next.js with React & Node - Beautiful Portfolio App

☞ Build a Blockchain & Cryptocurrency | Full-Stack Edition

Angular 9 Tutorial: Learn to Build a CRUD Angular App Quickly

What's new in Bootstrap 5 and when Bootstrap 5 release date?

Brave, Chrome, Firefox, Opera or Edge: Which is Better and Faster?

How to Build Progressive Web Apps (PWA) using Angular 9

What is new features in Javascript ES2020 ECMAScript 2020

How to Use Express.js, Node.js and MongoDB.js

In this post, I will show you how to use Express.js, Node.js and MongoDB.js. We will be creating a very simple Node application, that will allow users to input data that they want to store in a MongoDB database. It will also show all items that have been entered into the database.

Node.js for Beginners - Learn Node.js from Scratch (Step by Step)

Node.js for Beginners - Learn Node.js from Scratch (Step by Step) - Learn the basics of Node.js. This Node.js tutorial will guide you step by step so that you will learn basics and theory of every part. Learn to use Node.js like a professional. You’ll learn: Basic Of Node, Modules, NPM In Node, Event, Email, Uploading File, Advance Of Node.

Top 7 Most Popular Node.js Frameworks You Should Know

Node.js is an open-source, cross-platform, runtime environment that allows developers to run JavaScript outside of a browser. In this post, you'll see top 7 of the most popular Node frameworks at this point in time (ranked from high to low by GitHub stars).