Cloudflare Test Harness

index.test.ts

import { createTestHarness } from "wrangler";
import { beforeAll, afterEach, afterAll, test } from "vitest";

// Initialize the test harness pointing to your Cloudflare Worker config
const server = createTestHarness({
  workers: [
    { configPath: "./wrangler.jsonc" } // or wrangler.toml
  ],
});

// Manage the server lifecycle across your test suite
beforeAll(async () => {
  await server.listen();
});

afterEach(async () => {
  // Resets storage bindings and restores initial state after each test
  await server.reset();
});

afterAll(async () => {
  await server.close();
});

// Write your actual test cases
test("responds with Hello World", async ({ expect }) => {
  // server.fetch() sends a request straight to your built Worker code
  const response = await server.fetch("/");
  
  expect(response.status).toBe(200);
  expect(await response.text()).toBe("Hello World");
});