pptr-mock-server

Tiny library for backendless testing using Puppeteer.

$3

This library allows to define mock backend responses when testing web app with
Puppeteer.

Internally it works purely via Puppeteer API using built-in
setRequestInterception mechanism. It doesn't set up any servers and doesn't
modify any window APIs like XMLHttpRequest. This provides great flexibility
and performance when handling requests, since it operates on browser internal
level.

NOTE: we use this library heavily in automated tests for Dock and related
projects, but api surface is minimalistic, so it may not fit your needs.
Contributions are welcome, so we can make this library more flexible and cover
more usage scenarios.

Recommended reading: Automated UI Testing at Dock.

$3

``
yarn add -D pptr-mock-server
`

$3

`JavaScript
import puppeteer from 'puppeteer';
import mockServer from 'pptr-mock-server';

// typically your global test setup
const browser = await puppeteer.launch();
const page = await browser.newPage();
const baseAppUrl = 'http://localhost';
this.mockRequest = await mockServer.init(page, {
baseAppUrl,
baseApiUrl: baseAppUrl + '/api/'
});
`

$3

Once you have an instance of MockRequest you can pass it to your tests for registering mock responses:

`JavaScript
const responseConfig = {body: {result: 'ok'}};
this.mockRequest.on('GET', 'http://localhost/api/account', 200, responseConfig);
`

But since you provided baseApiUrl as http://localhost/api, you can use relative endpoint name. Also you can use .get() shorthand method instead of .on():

`JavaScript
const responseConfig = {body: {result: 'ok'}};
this.mockRequest.get('account', 200, responseConfig);
`

When your app performs request to the specified resource, it will respond with
the mock response provided.

#### Mocking sequence of identical requests

Once you setup a mock request handler, every matching request will be responded with it. However it's a common scenario when you need to mock a sequence of requests, when over time the same request produces different results. Recommended way to do it is to replace previously registered mock response using new one:

`JavaScript
const responseConfig = {body: {result: 'ok'}};
this.mockRequest.get('account', 200, responseConfig); // returns 200 on each request
// test deleting account logic here
// after account is deleted we want to return 401 instead of 200
this.mockRequest.get('account', 401); // replaces existing handler
``

Full api docs