Keploy logo
Deno logo

Keploy as a Deno testing framework

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

Generate Deno tests free
keploy record -c "deno run --allow-all main.ts"
18.4K+VS Code1.2M+300M+mocks created

What Keploy gives a Deno team

Any Deno service, unchanged

Keploy runs the process you already run with deno run. Oak, Hono, Fresh and a bare Deno.serve handler all record identically, because capture is at the socket rather than inside the runtime.

  • Deno 1.x and 2.x
  • Oak, Hono, Fresh, Deno.serve
  • npm: and jsr: specifiers alike
  • No import map changes
The problem

Why Deno 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 Deno: by hand, with deno test + fetch stubs, or with Keploy

deno test + fetch stubs 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 Deno 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.ts
hand-written
import { assertEquals } from "jsr:@std/assert";
import { handler } from "./orders.ts";
 
// A fake client, so the Postgres driver never runs.
const db = {
queryObject: () =>
Promise.resolve({ rows: [{ id: "o-1", total: 4200, status: "NEW" }] }),
};
 
const realFetch = globalThis.fetch;
 
Deno.test("confirms an order", async () => {
// Replace the runtime's own fetch, and remember to put it back.
globalThis.fetch = () =>
Promise.resolve(new Response(JSON.stringify({ status: "AUTHORIZED" })));
try {
const res = await handler(new Request("http://localhost/orders/o-1/confirm", {
method: "POST",
}), db);
assertEquals(res.status, 200);
} finally {
globalThis.fetch = realFetch;
}
});

The stub and the fake client exist only for this test.

deno test + fetch stubs1–2 hours
orders_stub_test.ts
tool-assisted
import { assertEquals } from "jsr:@std/assert";
import { Client } from "jsr:@db/postgres";
import { handler } from "./orders.ts";
 
// A real Postgres, so the job needs one running.
const db = new Client(Deno.env.get("DATABASE_URL"));
await db.connect();
 
// A stub upstream on a real port, which the handler must be pointed at.
const stub = Deno.serve({ port: 8787 }, () =>
new Response(JSON.stringify({ status: "AUTHORIZED" })),
);
 
Deno.test("confirms an order", async () => {
Deno.env.set("PAYMENTS_URL", "http://localhost:8787");
const res = await handler(new Request("http://localhost/orders/o-1/confirm", {
method: "POST",
}), db);
assertEquals(res.status, 200);
});

A stub server per upstream, and a real database to seed.

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

Deno 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 Deno app once, replay it forever

Keploy sits below your Deno 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 Deno service and captures the dependency calls it makes.

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 Deno, with zero config

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

Quick start

Your first Deno test suite in under five minutes

Every command below runs against your existing Deno 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 "deno run --allow-all main.ts"
  3. 3Exercise the paths you care about

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

    curl -X POST localhost:8000/orders/o-1/confirm
    curl localhost:8000/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 "deno run --allow-all main.ts" --delay 10

Ready to try it on your own Deno service?

Ecosystem

Works with the rest of your Deno stack

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

FAQ

Deno 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.