import { type AddressInfo, createServer } from "node:net"; import { fetch as realFetch } from "undici"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; let testPort = 0; let _cdpBaseUrl = ""; let reachable = false; let cfgAttachOnly = false; let createTargetId: string | null = null; const cdpMocks = vi.hoisted(() => ({ createTargetViaCdp: vi.fn(async () => { throw new Error("cdp disabled"); }), snapshotAria: vi.fn(async () => ({ nodes: [{ ref: "1", role: "link", name: "x", depth: 0 }], })), })); const pwMocks = vi.hoisted(() => ({ armDialogViaPlaywright: vi.fn(async () => {}), armFileUploadViaPlaywright: vi.fn(async () => {}), clickViaPlaywright: vi.fn(async () => {}), closePageViaPlaywright: vi.fn(async () => {}), closePlaywrightBrowserConnection: vi.fn(async () => {}), downloadViaPlaywright: vi.fn(async () => ({ url: "https://example.com/report.pdf", suggestedFilename: "report.pdf", path: "/tmp/report.pdf", })), dragViaPlaywright: vi.fn(async () => {}), evaluateViaPlaywright: vi.fn(async () => "ok"), fillFormViaPlaywright: vi.fn(async () => {}), getConsoleMessagesViaPlaywright: vi.fn(async () => []), hoverViaPlaywright: vi.fn(async () => {}), scrollIntoViewViaPlaywright: vi.fn(async () => {}), navigateViaPlaywright: vi.fn(async () => ({ url: "https://example.com" })), pdfViaPlaywright: vi.fn(async () => ({ buffer: Buffer.from("pdf") })), pressKeyViaPlaywright: vi.fn(async () => {}), responseBodyViaPlaywright: vi.fn(async () => ({ url: "https://example.com/api/data", status: 200, headers: { "content-type": "application/json" }, body: '{"ok":true}', })), resizeViewportViaPlaywright: vi.fn(async () => {}), selectOptionViaPlaywright: vi.fn(async () => {}), setInputFilesViaPlaywright: vi.fn(async () => {}), snapshotAiViaPlaywright: vi.fn(async () => ({ snapshot: "ok" })), takeScreenshotViaPlaywright: vi.fn(async () => ({ buffer: Buffer.from("png"), })), typeViaPlaywright: vi.fn(async () => {}), waitForDownloadViaPlaywright: vi.fn(async () => ({ url: "https://example.com/report.pdf", suggestedFilename: "report.pdf", path: "/tmp/report.pdf", })), waitForViaPlaywright: vi.fn(async () => {}), })); function makeProc(pid = 123) { const handlers = new Map void>>(); return { pid, killed: false, exitCode: null as number | null, on: (event: string, cb: (...args: unknown[]) => void) => { handlers.set(event, [...(handlers.get(event) ?? []), cb]); return undefined; }, emitExit: () => { for (const cb of handlers.get("exit") ?? []) cb(0); }, kill: () => { return true; }, }; } const proc = makeProc(); vi.mock("../config/config.js", async (importOriginal) => { const actual = await importOriginal(); return { ...actual, loadConfig: () => ({ browser: { enabled: true, controlUrl: `http://127.0.0.1:${testPort}`, color: "#FF4500", attachOnly: cfgAttachOnly, headless: true, defaultProfile: "clawd", profiles: { clawd: { cdpPort: testPort + 1, color: "#FF4500" }, }, }, }), writeConfigFile: vi.fn(async () => {}), }; }); const launchCalls = vi.hoisted(() => [] as Array<{ port: number }>); vi.mock("./chrome.js", () => ({ isChromeCdpReady: vi.fn(async () => reachable), isChromeReachable: vi.fn(async () => reachable), launchClawdChrome: vi.fn(async (_resolved: unknown, profile: { cdpPort: number }) => { launchCalls.push({ port: profile.cdpPort }); reachable = true; return { pid: 123, exe: { kind: "chrome", path: "/fake/chrome" }, userDataDir: "/tmp/clawd", cdpPort: profile.cdpPort, startedAt: Date.now(), proc, }; }), resolveClawdUserDataDir: vi.fn(() => "/tmp/clawd"), stopClawdChrome: vi.fn(async () => { reachable = false; }), })); vi.mock("./cdp.js", () => ({ createTargetViaCdp: cdpMocks.createTargetViaCdp, normalizeCdpWsUrl: vi.fn((wsUrl: string) => wsUrl), snapshotAria: cdpMocks.snapshotAria, })); vi.mock("./pw-ai.js", () => pwMocks); vi.mock("../media/store.js", () => ({ ensureMediaDir: vi.fn(async () => {}), saveMediaBuffer: vi.fn(async () => ({ path: "/tmp/fake.png" })), })); vi.mock("./screenshot.js", () => ({ DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES: 128, DEFAULT_BROWSER_SCREENSHOT_MAX_SIDE: 64, normalizeBrowserScreenshot: vi.fn(async (buf: Buffer) => ({ buffer: buf, contentType: "image/png", })), })); async function getFreePort(): Promise { while (true) { const port = await new Promise((resolve, reject) => { const s = createServer(); s.once("error", reject); s.listen(0, "127.0.0.1", () => { const assigned = (s.address() as AddressInfo).port; s.close((err) => (err ? reject(err) : resolve(assigned))); }); }); if (port < 65535) return port; } } function makeResponse( body: unknown, init?: { ok?: boolean; status?: number; text?: string }, ): Response { const ok = init?.ok ?? true; const status = init?.status ?? 200; const text = init?.text ?? ""; return { ok, status, json: async () => body, text: async () => text, } as unknown as Response; } describe("browser control server", () => { beforeEach(async () => { reachable = false; cfgAttachOnly = false; createTargetId = null; cdpMocks.createTargetViaCdp.mockImplementation(async () => { if (createTargetId) return { targetId: createTargetId }; throw new Error("cdp disabled"); }); for (const fn of Object.values(pwMocks)) fn.mockClear(); for (const fn of Object.values(cdpMocks)) fn.mockClear(); testPort = await getFreePort(); _cdpBaseUrl = `http://127.0.0.1:${testPort + 1}`; // Minimal CDP JSON endpoints used by the server. let putNewCalls = 0; vi.stubGlobal( "fetch", vi.fn(async (url: string, init?: RequestInit) => { const u = String(url); if (u.includes("/json/list")) { if (!reachable) return makeResponse([]); return makeResponse([ { id: "abcd1234", title: "Tab", url: "https://example.com", webSocketDebuggerUrl: "ws://127.0.0.1/devtools/page/abcd1234", type: "page", }, { id: "abce9999", title: "Other", url: "https://other", webSocketDebuggerUrl: "ws://127.0.0.1/devtools/page/abce9999", type: "page", }, ]); } if (u.includes("/json/new?")) { if (init?.method === "PUT") { putNewCalls += 1; if (putNewCalls === 1) { return makeResponse({}, { ok: false, status: 405, text: "" }); } } return makeResponse({ id: "newtab1", title: "", url: "about:blank", webSocketDebuggerUrl: "ws://127.0.0.1/devtools/page/newtab1", type: "page", }); } if (u.includes("/json/activate/")) return makeResponse("ok"); if (u.includes("/json/close/")) return makeResponse("ok"); return makeResponse({}, { ok: false, status: 500, text: "unexpected" }); }), ); }); afterEach(async () => { vi.unstubAllGlobals(); vi.restoreAllMocks(); const { stopBrowserControlServer } = await import("./server.js"); await stopBrowserControlServer(); }); it("POST /tabs/open?profile=unknown returns 404", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/tabs/open?profile=unknown`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ url: "https://example.com" }), }); expect(result.status).toBe(404); const body = (await result.json()) as { error: string }; expect(body.error).toContain("not found"); }); }); describe("profile CRUD endpoints", () => { beforeEach(async () => { reachable = false; cfgAttachOnly = false; for (const fn of Object.values(pwMocks)) fn.mockClear(); for (const fn of Object.values(cdpMocks)) fn.mockClear(); testPort = await getFreePort(); _cdpBaseUrl = `http://127.0.0.1:${testPort + 1}`; vi.stubGlobal( "fetch", vi.fn(async (url: string) => { const u = String(url); if (u.includes("/json/list")) return makeResponse([]); return makeResponse({}, { ok: false, status: 500, text: "unexpected" }); }), ); }); afterEach(async () => { vi.unstubAllGlobals(); vi.restoreAllMocks(); const { stopBrowserControlServer } = await import("./server.js"); await stopBrowserControlServer(); }); it("POST /profiles/create returns 400 for missing name", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/create`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({}), }); expect(result.status).toBe(400); const body = (await result.json()) as { error: string }; expect(body.error).toContain("name is required"); }); it("POST /profiles/create returns 400 for invalid name format", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/create`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name: "Invalid Name!" }), }); expect(result.status).toBe(400); const body = (await result.json()) as { error: string }; expect(body.error).toContain("invalid profile name"); }); it("POST /profiles/create returns 409 for duplicate name", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; // "clawd" already exists as the default profile const result = await realFetch(`${base}/profiles/create`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name: "clawd" }), }); expect(result.status).toBe(409); const body = (await result.json()) as { error: string }; expect(body.error).toContain("already exists"); }); it("POST /profiles/create accepts cdpUrl for remote profiles", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/create`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name: "remote", cdpUrl: "http://10.0.0.42:9222" }), }); expect(result.status).toBe(200); const body = (await result.json()) as { profile?: string; cdpUrl?: string; isRemote?: boolean; }; expect(body.profile).toBe("remote"); expect(body.cdpUrl).toBe("http://10.0.0.42:9222"); expect(body.isRemote).toBe(true); }); it("POST /profiles/create returns 400 for invalid cdpUrl", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/create`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name: "badremote", cdpUrl: "ws://bad" }), }); expect(result.status).toBe(400); const body = (await result.json()) as { error: string }; expect(body.error).toContain("cdpUrl"); }); it("DELETE /profiles/:name returns 404 for non-existent profile", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/nonexistent`, { method: "DELETE", }); expect(result.status).toBe(404); const body = (await result.json()) as { error: string }; expect(body.error).toContain("not found"); }); it("DELETE /profiles/:name returns 400 for default profile deletion", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; // clawd is the default profile const result = await realFetch(`${base}/profiles/clawd`, { method: "DELETE", }); expect(result.status).toBe(400); const body = (await result.json()) as { error: string }; expect(body.error).toContain("cannot delete the default profile"); }); it("DELETE /profiles/:name returns 400 for invalid name format", async () => { const { startBrowserControlServerFromConfig } = await import("./server.js"); await startBrowserControlServerFromConfig(); const base = `http://127.0.0.1:${testPort}`; const result = await realFetch(`${base}/profiles/Invalid-Name!`, { method: "DELETE", }); expect(result.status).toBe(400); const body = (await result.json()) as { error: string }; expect(body.error).toContain("invalid profile name"); }); });