import { describe, it, expect, vi, afterEach, beforeEach } from "vitest"; import { binaryInfo } from "../src/download.js"; import { DEFAULT_VIEWPORT, getChromiumVersion } from "../src/config.js"; describe("binaryInfo", () => { it("returns correct structure", () => { const info = binaryInfo(); expect(info.version).toBe(getChromiumVersion()); expect(info.platform).toMatch(/^(linux|darwin|windows)-(x64|arm64)$/); expect(info.binaryPath).toBeTruthy(); expect(typeof info.installed).toBe("boolean"); expect(info.cacheDir).toContain("cloakbrowser"); expect(info.downloadUrl).toContain(".tar.gz"); }); }); // Integration tests require the binary — run with: // CLOAKBROWSER_BINARY_PATH=/path/to/chrome npm test describe.skipIf(!process.env.CLOAKBROWSER_BINARY_PATH)( "launch (integration)", () => { it("launches browser and checks stealth", async () => { const { launch } = await import("../src/playwright.js"); const browser = await launch({ headless: true }); const page = await browser.newPage(); await page.goto("about:blank"); const webdriver = await page.evaluate(() => navigator.webdriver); expect(webdriver).toBeFalsy(); const plugins = await page.evaluate(() => navigator.plugins.length); expect(plugins).toBeGreaterThan(0); await browser.close(); }, 30_000); } ); // --------------------------------------------------------------------------- // launchContext / launchPersistentContext unit tests (mock playwright-core) // --------------------------------------------------------------------------- describe("launchContext (unit)", () => { let mockContext: any; let mockBrowser: any; let mockChromium: any; let origNewContext: any; const origEnv = process.env.CLOAKBROWSER_BINARY_PATH; beforeEach(() => { process.env.CLOAKBROWSER_BINARY_PATH = "/fake/chrome"; const origClose = vi.fn(); mockContext = { close: origClose, _origClose: origClose, newPage: vi.fn(), on: vi.fn(), pages: vi.fn().mockReturnValue([]) }; origNewContext = vi.fn().mockResolvedValue(mockContext); mockBrowser = { newContext: origNewContext, newPage: vi.fn(), close: vi.fn(), }; mockChromium = { launch: vi.fn().mockResolvedValue(mockBrowser) }; vi.doMock("playwright-core", () => ({ chromium: mockChromium })); }); afterEach(() => { vi.restoreAllMocks(); vi.resetModules(); if (origEnv) { process.env.CLOAKBROWSER_BINARY_PATH = origEnv; } else { delete process.env.CLOAKBROWSER_BINARY_PATH; } }); it("applies DEFAULT_VIEWPORT when no viewport given", async () => { const { launchContext } = await import("../src/playwright.js"); await launchContext(); const ctxArgs = origNewContext.mock.calls[0][0]; expect(ctxArgs.viewport).toEqual(DEFAULT_VIEWPORT); }); it("uses custom viewport when provided", async () => { const { launchContext } = await import("../src/playwright.js"); const custom = { width: 1280, height: 720 }; await launchContext({ viewport: custom }); const ctxArgs = origNewContext.mock.calls[0][0]; expect(ctxArgs.viewport).toEqual(custom); }); it("forwards userAgent to newContext", async () => { const { launchContext } = await import("../src/playwright.js"); await launchContext({ userAgent: "Custom/1.0" }); const ctxArgs = origNewContext.mock.calls[0][0]; expect(ctxArgs.userAgent).toBe("Custom/1.0"); }); it("passes timezone via binary flag, not CDP context", async () => { const { launchContext } = await import("../src/playwright.js"); await launchContext({ timezone: "America/New_York" }); // launch() called with --fingerprint-timezone binary flag const launchArgs = mockChromium.launch.mock.calls[0][0]; const hasTimezoneFlag = launchArgs.args.some((a: string) => a.startsWith("--fingerprint-timezone=America/New_York") ); expect(hasTimezoneFlag).toBe(true); // NOT in newContext() — no CDP emulation const ctxArgs = origNewContext.mock.calls[0][0]; expect(ctxArgs.timezoneId).toBeUndefined(); }); it("forwards colorScheme to newContext", async () => { const { launchContext } = await import("../src/playwright.js"); await launchContext({ colorScheme: "dark" }); const ctxArgs = origNewContext.mock.calls[0][0]; expect(ctxArgs.colorScheme).toBe("dark"); }); it("close() also closes browser", async () => { const { launchContext } = await import("../src/playwright.js"); const ctx = await launchContext(); await ctx.close(); // Original context close called expect(mockContext._origClose).toHaveBeenCalledOnce(); // Browser also closed expect(mockBrowser.close).toHaveBeenCalledOnce(); }); }); // --------------------------------------------------------------------------- // stealth_evaluate patching unit tests // --------------------------------------------------------------------------- describe("stealthEvaluate patching (unit)", () => { const origEnv = process.env.CLOAKBROWSER_BINARY_PATH; let mockPage: any; let mockContext: any; let mockBrowser: any; beforeEach(() => { process.env.CLOAKBROWSER_BINARY_PATH = "/fake/chrome"; // Page mock with context() returning the implicit context mockPage = { context: vi.fn(), }; // Implicit context created by browser.newPage() mockContext = { pages: vi.fn().mockReturnValue([]), newPage: vi.fn(), on: vi.fn(), }; mockPage.context.mockReturnValue(mockContext); mockBrowser = { newContext: vi.fn().mockResolvedValue(mockContext), newPage: vi.fn().mockResolvedValue(mockPage), close: vi.fn(), }; const mockChromium = { launch: vi.fn().mockResolvedValue(mockBrowser) }; vi.doMock("playwright-core", () => ({ chromium: mockChromium })); }); afterEach(() => { vi.restoreAllMocks(); vi.resetModules(); if (origEnv) { process.env.CLOAKBROWSER_BINARY_PATH = origEnv; } else { delete process.env.CLOAKBROWSER_BINARY_PATH; } }); it("page.stealthEvaluate exists after launch + browser.newPage", async () => { const { launch } = await import("../src/playwright.js"); const browser = await launch({ headless: true }); const page = await browser.newPage(); expect(typeof (page as any).stealthEvaluate).toBe("function"); }); it("implicit context from browser.newPage is patched for future pages", async () => { const { launch } = await import("../src/playwright.js"); const browser = await launch({ headless: true }); await browser.newPage(); // The 'page' event listener should be registered on the implicit context expect(mockContext.on).toHaveBeenCalledWith("page", expect.any(Function)); // The context should be marked as patched expect((mockContext as any)._stealthEvalPatched).toBe(true); }); it("context from browser.newContext patches pages with stealthEvaluate", async () => { const { launch } = await import("../src/playwright.js"); const browser = await launch({ headless: true }); const mockPage2: any = { context: vi.fn().mockReturnValue(mockContext) }; mockContext.newPage.mockResolvedValue(mockPage2); mockContext.pages.mockReturnValue([]); const ctx = await browser.newContext(); const page = await ctx.newPage(); expect(typeof (page as any).stealthEvaluate).toBe("function"); }); }); describe("launchPersistentContext (unit)", () => { let mockContext: any; let mockChromium: any; const origEnv = process.env.CLOAKBROWSER_BINARY_PATH; beforeEach(() => { process.env.CLOAKBROWSER_BINARY_PATH = "/fake/chrome"; mockContext = { close: vi.fn(), pages: vi.fn().mockReturnValue([]), newPage: vi.fn(), on: vi.fn() }; mockChromium = { launchPersistentContext: vi.fn().mockResolvedValue(mockContext), }; vi.doMock("playwright-core", () => ({ chromium: mockChromium })); }); afterEach(() => { vi.restoreAllMocks(); vi.resetModules(); if (origEnv) { process.env.CLOAKBROWSER_BINARY_PATH = origEnv; } else { delete process.env.CLOAKBROWSER_BINARY_PATH; } }); it("applies DEFAULT_VIEWPORT", async () => { const { launchPersistentContext } = await import("../src/playwright.js"); await launchPersistentContext({ userDataDir: "/tmp/profile" }); const args = mockChromium.launchPersistentContext.mock.calls[0][1]; expect(args.viewport).toEqual(DEFAULT_VIEWPORT); }); it("passes timezone and locale via binary args, not CDP context", async () => { const { launchPersistentContext } = await import("../src/playwright.js"); await launchPersistentContext({ userDataDir: "/tmp/profile", timezone: "Asia/Tokyo", locale: "ja-JP", }); const args = mockChromium.launchPersistentContext.mock.calls[0][1]; // Binary args (native, undetectable) expect(args.args).toContain("--fingerprint-timezone=Asia/Tokyo"); expect(args.args).toContain("--lang=ja-JP"); // NOT in context kwargs (would trigger detectable CDP emulation) expect(args.timezoneId).toBeUndefined(); expect(args.locale).toBeUndefined(); }); it("forwards proxy string", async () => { const { launchPersistentContext } = await import("../src/playwright.js"); await launchPersistentContext({ userDataDir: "/tmp/profile", proxy: "http://user:pass@proxy:8080", }); const args = mockChromium.launchPersistentContext.mock.calls[0][1]; expect(args.proxy.server).toBe("http://proxy:8080"); expect(args.proxy.username).toBe("user"); expect(args.proxy.password).toBe("pass"); }); it("forwards userAgent and colorScheme", async () => { const { launchPersistentContext } = await import("../src/playwright.js"); await launchPersistentContext({ userDataDir: "/tmp/profile", userAgent: "Custom/1.0", colorScheme: "dark", }); const args = mockChromium.launchPersistentContext.mock.calls[0][1]; expect(args.userAgent).toBe("Custom/1.0"); expect(args.colorScheme).toBe("dark"); }); });