cypress-http-cache

A blazing fast in-memory HTTP cache to speed up Cypress End-to-End test suites.

What it solves

With npx cypress run, Cypress uses a fresh browser for each test file. This completely wipes the browser cache, removing any performance benefit. cypress-http-cache aims to solve this problem through an in-memory caching proxy that persists through the test run. This proxy sits between Cypress and your web application and caches its assets for faster page loading.

Compatibility

Cypress 10+

Installation

npm install cypress-http-cache --save-dev

How to configure it

In your config file, call installHttpCache in the setupNodeEvents block:

const { defineConfig } = require('cypress');
const { installHttpCache } = require('cypress-http-cache');

module.exports = defineConfig({
  e2e: {
    async setupNodeEvents(on, config) {
      return installHttpCache(on, config);
    },
    baseUrl: "http://localhost:3000"
  },
});

Options

You can pass an optional configuration object as the third argument to installHttpCache:

| Option | Type | Default | Description | | :--- | :--- | :--- | :--- | | cacheSize | number | 100 | Maximum cache size in megabytes. Requests larger than this will not be cached. | | stats | 'never' \| 'after:spec' \| 'after:run' | after:run | When to print cache metrics. See below for details. | | addCacheHeaders | boolean | true | Whether to inject proxy diagnostic headers (X-Cache and Server-Timing) into network responses. | | secure | boolean | false | Whether to verify the upstream server's TLS certificate. | | detached | boolean \| string | false | If true, the proxy runs in a detached background process (useful for shared CI). If a URL string (e.g., 'http://localhost:3000'), the plugin assumes a proxy is already running there and uses it. Proxy stopping is NOT handled in detached mode. |

Tip: If you enable secure and your target uses a private or internal CA, trust it via the standard Node.js environment variable: NODE_EXTRA_CA_CERTS=/path/to/ca.pem npx cypress run

Stats

When stats is enabled, a summary is automatically printed to your terminal at the end of every Cypress suite run, detailing the usage of the cache.

[Cypress HTTP Cache] 75.0% hits (3/4) | 0.0/100.0 MB (1 keys)

Small print

Author: Yoann Rouxel © 2026

License: MIT - do anything with the code, but don't blame me if it does not work.

Support: if you find any problems with this module open issue on Github