cypress-plugin-network-shim

cypress-plugin-network-shim

This is a utility for Cypress.io end-to-end testing which enables recording snapshots of real backend traffic.

The generated snapshots can then be used to replay or "stub" the network on subsequent test runs, effectively mocking out the server to increase test repeatability and performance.

Modes of operation

There are three modes of operation:

• GENERATE - record network requests and responses, generate fixtures for future stubbing
• STUB - Use exiting network fixtures to stub application network responses.
• SKIP - Operate end-to-end as if the network shim weren't in place.

Usage

Your project must be using Cypress:

yarn install --dev cypress
yarn install --dev cypress-plugin-network-shim

In a test file, i.e. cypress/integration/test.spec.js, add the following:

before(() => {
  Cypress.NetworkShim.enable({
    specName: 'test',
  });
});

At this point, the network shim will be enabled whenever this test is run.

Environment Variables

> export CYPRESS_NETWORK_SHIM_HOST_API=https://api.example.com
> export CYPRESS_NETWORK_SHIM_MODE=GENERATE
> cypress

OR

> cypress --env NETWORK_SHIM_HOST_API=https://api.example.com --env NETWORK_SHIM_MODE=GENERATE

Configuration

To set default app-wide network shim configuration, in cypress/support/index.js add the following:

Cypress.NetworkShim.defaults({
  hosts: {
    'api': 'https://api.example.com'
  }
});