How Do I Mock a Web Server?


Heather Bennett

Mocking a web server is a crucial skill for any web developer or tester. By simulating the behavior of a real server, you can thoroughly test your application without relying on external services. In this tutorial, we will explore different methods to mock a web server and discuss their benefits.

Why Mock a Web Server?

Before diving into the details, let’s understand why mocking a web server is important. When developing or testing an application that relies on external APIs or services, it’s essential to have control over the responses.

Real servers may be unpredictable, slow, or even charge fees for usage. By mocking the server, you can create consistent responses and simulate various scenarios to thoroughly test your application.

Making Use of JavaScript

If you’re looking for a lightweight solution to mock a web server, JavaScript libraries like JSON Server and Pretender are excellent choices. These libraries allow you to define routes and their corresponding responses easily.

JSON Server

JSON Server is an easy-to-use package that creates a RESTful API based on a JSON file. You can quickly set up routes by defining endpoints and their desired responses in the JSON file.

  "posts": [
    { "id": 1, "title": "Mocking Made Easy", "author": "John Doe" },
    { "id": 2, "title": "Testing Techniques", "author": "Jane Smith" }


Pretender is a JavaScript library that allows you to intercept and respond to XMLHttpRequests. It’s perfect for mocking server responses in your tests or development environment. With Pretender, you can define routes and their corresponding handlers using a simple syntax.

import Pretender from 'pretender';

const server = new Pretender(function() {
  this.get('/api/posts', function(request) {
    const response = { posts: [{ id: 1, title: 'Mocking Made Easy' }] };
    return [200, { 'Content-Type': 'application/json' }, JSON.stringify(response)];

Using Mocking Frameworks

If you’re working with more complex scenarios or need advanced features like request verification and response customization, using a dedicated mocking framework can be beneficial. Here are two popular options:


WireMock is a flexible and powerful stubbing and mocking web service. It allows you to define detailed mappings between requests and responses, including headers, query parameters, and body content. WireMock can be run as a standalone server or embedded within your application.

  "request": {
    "method": "GET",
    "urlPath": "/api/posts"
  "response": {
    "status": 200,
    "headers": { "Content-Type": "application/json" },
    "jsonBody": {
      "posts": [{ "id": 1, "title": "Mocking Made Easy" }]


Mountebank is an open-source tool that allows you to create custom HTTP servers. It supports various protocols and provides powerful features like request matching, response templating, and recording interactions. Mountebank can be run as a standalone service or used programmatically.

  "protocol": "http",
  "port": 3000,
  "stubs": [
      "predicates": [{ "equals": { "method": "GET", "path": "/api/posts" } }],
      "responses": [
          "is": {
            "statusCode": 200,
            "headers": { "Content-Type": "application/json" },
            "body": { "posts": [{ "id": 1, "title": "Mocking Made Easy" }] }


In this tutorial, we explored different methods to mock a web server and their benefits. Whether you choose JavaScript libraries like JSON Server and Pretender or dedicated mocking frameworks like WireMock and Mountebank, the ability to simulate server behavior is essential for thorough testing and development.

Now that you have learned how to mock a web server effectively, you can confidently test your applications without relying on external services or worrying about unpredictable responses.

Discord Server - Web Server - Private Server - DNS Server - Object-Oriented Programming - Scripting - Data Types - Data Structures

Privacy Policy