@kiwa-lab/e2e

End-to-end test adapter for kiwa — Playwright + built-in HTTP serve helper.

Overview

@kiwa-lab/e2e exposes a single setupE2eEnv helper that:

• spins up a real HTTP server (your fetch app, Node handler, or a static HTML string),
• launches Playwright Chromium (or Firefox / WebKit) in headless mode,
• navigates to the initial path, and
• returns a thin BrowserPageHandle you can drive from vitest with getByTestId, fill, click, evaluate, etc.

Unlike @kiwa-lab/dapp (which is anchored on dApp + anvil), @kiwa-lab/e2e targets generic web apps.

Install

pnpm add -D @kiwa-lab/e2e @kiwa-lab/core @playwright/test vitest
pnpm exec playwright install chromium

Quick start

import { afterEach, describe, expect, it } from "vitest";
import { setupE2eEnv, type E2eTestEnv } from "@kiwa-lab/e2e";

const envs: E2eTestEnv[] = [];
afterEach(async () => {
  while (envs.length > 0) {
    const env = envs.pop();
    if (env) await env.stop();
  }
});

it("adds an item via real form submit", async () => {
  const env = await setupE2eEnv({
    staticHtml: "<form id='f'><input id='i' /></form>",
  });
  envs.push(env);
  await env.page.fill("#i", "walk the dog");
  await env.page.click("button[type='submit']");
});

Provide { app: { kind: 'fetch', handler } } to mount a real fetch handler instead of static HTML.

License

MIT