Keploy logo
JavaScript logo

Keploy as a JavaScript testing framework

Keploy tests JavaScript services by recording real HTTP and database traffic from a running process, then replaying it as assertions. There is no module registry to patch and nothing to mock by hand, because capture happens below the runtime at the socket.

Generate JavaScript tests free
keploy record -c "node server.js"
18.4K+VS Code1.2M+300M+mocks created

What Keploy gives a JavaScript team

Any JavaScript service, unchanged

Keploy runs the process you already run with node. Express, Fastify, Koa, Hapi and a bare http server all record identically, because capture is at the socket rather than inside the framework.

  • Node 14 and above
  • Express, Fastify, Koa, Hapi
  • CommonJS and ESM alike
  • No bundler changes
The problem

Why JavaScript integration tests slow teams down

The friction is rarely the assertions. It is everything around them — spinning up dependencies, keeping mocks honest, and repairing tests after every refactor.

Three ways to do it

Testing JavaScript: by hand, with Jest + Sinon, or with Keploy

Jest + Sinon describes the exchange by hand and still needs the dependency supplied. Keploy records both halves once and replays them with nothing running.

Select any row for the full comparison, with code.

Same coverage, three costs

What you write for JavaScript vs what Keploy records

All three produce the same assertion. Only the third still passes after the next refactor without anyone editing it.

By hand2–4 hours
orders.test.js
hand-written
const request = require('supertest');
const { app } = require('./app');
 
// A fake Postgres client, so the driver never runs.
jest.mock('./db', () => ({
findOrder: () => Promise.resolve({ id: 'o-1', total: 4200, status: 'NEW' }),
}));
 
// And the upstream, stubbed per URL.
jest.mock('node-fetch', () => () =>
Promise.resolve({ json: () => ({ status: 'AUTHORIZED' }) }),
);
 
test('confirms an order', async () => {
const res = await request(app).post('/orders/o-1/confirm');
expect(res.status).toBe(200);
expect(res.body.status).toBe('CONFIRMED');
});

The fakes exist only for this test and drift the moment the schema does.

Jest + Sinon1–2 hours
orders.nock.test.js
tool-assisted
const request = require('supertest');
const nock = require('nock');
const { app } = require('./app');
 
beforeEach(() => {
// One interceptor per outbound URL, written by hand.
nock('https://api.payments.example.com')
.post('/v1/payment_intents/tok_123/confirm')
.reply(200, { status: 'AUTHORIZED' });
});
 
// A real Postgres is still needed, seeded before the run.
test('confirms an order', async () => {
const res = await request(app).post('/orders/o-1/confirm');
expect(res.status).toBe(200);
});

Jest + Sinon handles the HTTP half. The database is still yours to run.

With Keploy~5 minutes
keploy/test-set-0/test-1.yaml
auto-generated
version: api.keploy.io/v1beta1
kind: Http
name: test-1
spec:
req:
method: POST
url: /orders/o-1/confirm
resp:
status_code: 200
body: '{"id":"o-1","status":"CONFIRMED","total":4200}'
assertions:
noise:
- body.confirmedAt
---
kind: Postgres
spec:
query: select id, total, status from orders where id = $1
rows:
- { id: "o-1", total: 4200, status: "NEW" }
---
kind: Http
spec:
request:
url: https://api.payments.example.com/v1/payment_intents/tok_123/confirm
response:
body: '{"status":"AUTHORIZED"}'

Recorded from one real request. Nothing here was typed by hand.

Times are estimates for authoring one endpoint’s coverage from scratch, not measurements.

Keploy vs the alternatives

JavaScript testing tools, compared

The options a team on Node.js actually reaches for, and where each one genuinely wins. Select a row for the full comparison.

Best in classStrongPartialNot covered

Assessments reflect each tool’s documented behaviour, not benchmark measurements.

How it works

Record your JavaScript app once, replay it forever

Keploy sits below your JavaScript process at the network layer. It watches the calls your app already makes, then serves them back on replay so tests run with no dependencies attached.

Keploy records a GET call to /api/v1/orders/{id} on a JavaScript service and captures the dependency calls it makes.

JavaScript logo
Your JavaScript app
GET/api/v1/orders/{id}200
RecordingKeploy proxyeBPF · userspace
+3 more JavaScript dependencies
An example shape of a captured call. Your own endpoints and dependencies come from your real traffic, so nothing here has to be written by hand.
Mock coverage

What Keploy mocks for JavaScript, with zero config

6 of the 7 dependencies a typical JavaScript service talks to are stubbed from the recording itself — no mock classes, no fixture files, no containers in CI.

Quick start

Your first JavaScript test suite in under five minutes

Every command below runs against your existing JavaScript service. Nothing in your source tree changes.

  1. 1Install the Keploy CLI

    A single binary. It needs a Linux kernel with eBPF support, or Docker on macOS and Windows — and it adds nothing to your project's dependencies.

    curl -sSL https://keploy.io/install.sh | bash
  2. 2Record your service

    Pass the command you already use to start the app. Keploy runs it and watches every socket it opens.

    keploy record -c "node server.js"
  3. 3Exercise the paths you care about

    Use curl, your frontend, or an existing smoke script. Every request becomes a test case with its JavaScript calls captured alongside it.

    curl -X POST localhost:3000/orders/o-1/confirm
    curl localhost:3000/orders/o-1
  4. 4Replay in CI

    Replay serves the recorded dependency responses, so the job needs no service containers and no Docker daemon.

    keploy test -c "node server.js" --delay 10

Ready to try it on your own JavaScript service?

Ecosystem

Works with the rest of your JavaScript stack

Keploy records at the network layer, so framework and driver choices inside your JavaScript app do not change how it captures traffic.

FAQ

JavaScript testing with Keploy: common questions

Join our GlobalCommunity

Connect with developers worldwide. Follow updates, ask questions, share feedback, and ship faster with other Keploy builders.

1.2M+Installs
18.4K+GitHub
100K+Devs
300M+Mocks
1K+Contributors
#1OSS Trending
4.9★★★★★from 500+ reviews onG2GartnerVS CodeChrome
★★★★★

Best report of integration and API tests I've seen — which we don't get from RestAssured.

G2
★★★★★

Future of microservices testing. I don't write tests now!

G2 · 5/5
★★★★★

An amazing product that simplifies the automation.

Gartner · 4.0
XGitHubSlackYouTubeLinkedIn
Built by developers, for developers.Let's build the future, together.