@monoes/monobrowse 1.0.6 → 1.0.7

package/dist/src/__tests__/storage-eval.test.js

@@ -0,0 +1,133 @@
+/**
+ * storage.ts builds localStorage/sessionStorage expressions by string
+ * concatenation, so the JSON.stringify escaping is the only thing standing
+ * between a user-supplied key and script injection into the page. That plus
+ * evaluateJs's error/timeout contract is what this file pins down.
+ * Fake client throughout — no browser.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { evaluateJs } from '../browser/actions.js';
+import { getLocalStorageKey, setLocalStorageKey, removeLocalStorageKey, clearLocalStorage, getAllLocalStorage, getSessionStorageKey, setSessionStorageKey, removeSessionStorageKey, clearSessionStorage, getAllSessionStorage, } from '../browser/storage.js';
+/** Client stub returning a fixed Runtime.evaluate value, recording expressions. */
+function stubClient(value, exceptionDetails) {
+    const exprs = [];
+    const sids = [];
+    const client = {
+        send: vi.fn(async (_m, params, sid) => {
+            exprs.push(params.expression);
+            sids.push(sid);
+            return exceptionDetails ? { result: {}, exceptionDetails } : { result: { value, type: 'string' } };
+        }),
+    };
+    return { client, exprs, sids };
+}
+describe('evaluateJs', () => {
+    it('sends Runtime.evaluate with returnByValue and awaitPromise, scoped to the session', async () => {
+        const client = {
+            send: vi.fn(async () => ({ result: { value: 42, type: 'number' } })),
+        };
+        await expect(evaluateJs(client, 'S1', '1 + 41')).resolves.toBe(42);
+        expect(client.send.mock.calls[0]).toEqual([
+            'Runtime.evaluate',
+            { expression: '1 + 41', returnByValue: true, awaitPromise: true },
+            'S1',
+        ]);
+    });
+    it('surfaces the exception description when the page throws', async () => {
+        const { client } = stubClient(undefined, {
+            text: 'Uncaught',
+            exception: { description: 'ReferenceError: foo is not defined' },
+        });
+        await expect(evaluateJs(client, 'S1', 'foo')).rejects.toThrow('JS evaluation error: ReferenceError: foo is not defined');
+    });
+    it('falls back to exceptionDetails.text when there is no description', async () => {
+        const { client } = stubClient(undefined, { text: 'Uncaught SyntaxError' });
+        await expect(evaluateJs(client, 'S1', '{{')).rejects.toThrow('JS evaluation error: Uncaught SyntaxError');
+    });
+    it('returns undefined for an expression with no value', async () => {
+        const client = { send: vi.fn(async () => ({ result: { type: 'undefined' } })) };
+        await expect(evaluateJs(client, 'S1', 'void 0')).resolves.toBeUndefined();
+    });
+    it('rejects rather than hanging when the page never settles the promise', async () => {
+        // awaitPromise:true means a never-settling expression would hang forever
+        // without the race; a 20ms budget proves the timer is armed.
+        const client = { send: vi.fn(() => new Promise(() => { })) };
+        await expect(evaluateJs(client, 'S1', 'new Promise(() => {})', 20)).rejects.toThrow('JS evaluation timed out after 20ms');
+    });
+    it('waits indefinitely when the timeout is disabled with 0', async () => {
+        let resolveSend = () => { };
+        const client = {
+            send: vi.fn(() => new Promise((r) => { resolveSend = r; })),
+        };
+        const p = evaluateJs(client, 'S1', 'slow()', 0);
+        resolveSend({ result: { value: 'done', type: 'string' } });
+        await expect(p).resolves.toBe('done');
+    });
+});
+describe('localStorage helpers', () => {
+    it('reads a key through a JSON-escaped getItem call', async () => {
+        const { client, exprs, sids } = stubClient('v');
+        await expect(getLocalStorageKey(client, 'S1', 'token')).resolves.toBe('v');
+        expect(exprs[0]).toBe('localStorage.getItem("token")');
+        expect(sids[0]).toBe('S1');
+    });
+    it('escapes a key containing quotes and backslashes instead of breaking out', async () => {
+        const { client, exprs } = stubClient(null);
+        await getLocalStorageKey(client, 'S1', 'a"); alert(1); //');
+        expect(exprs[0]).toBe('localStorage.getItem("a\\"); alert(1); //")');
+        // The payload must survive as *one* string literal: round-tripping the
+        // argument back through JSON.parse recovers the key verbatim, which it
+        // could not if the quote had terminated the literal early.
+        const arg = exprs[0].slice('localStorage.getItem('.length, -1);
+        expect(JSON.parse(arg)).toBe('a"); alert(1); //');
+    });
+    it('escapes newlines in a key so the expression stays one statement', async () => {
+        const { client, exprs } = stubClient(null);
+        await removeLocalStorageKey(client, 'S1', 'a\nb');
+        expect(exprs[0]).toBe('localStorage.removeItem("a\\nb")');
+        expect(exprs[0]).not.toContain('\n');
+    });
+    it('escapes both key and value on write', async () => {
+        const { client, exprs } = stubClient();
+        await setLocalStorageKey(client, 'S1', 'k"1', 'v"2');
+        expect(exprs[0]).toBe('localStorage.setItem("k\\"1", "v\\"2")');
+    });
+    it('clears with a literal expression', async () => {
+        const { client, exprs } = stubClient();
+        await clearLocalStorage(client, 'S1');
+        expect(exprs[0]).toBe('localStorage.clear()');
+    });
+    it('getAll parses the JSON dump', async () => {
+        const { client } = stubClient('{"a":"1","b":"2"}');
+        await expect(getAllLocalStorage(client, 'S1')).resolves.toEqual({ a: '1', b: '2' });
+    });
+    it('getAll degrades to {} on unparseable output rather than throwing', async () => {
+        const { client } = stubClient('not json');
+        await expect(getAllLocalStorage(client, 'S1')).resolves.toEqual({});
+    });
+    it('getItem returning null (missing key) is passed through as null', async () => {
+        const { client } = stubClient(null);
+        await expect(getLocalStorageKey(client, 'S1', 'missing')).resolves.toBeNull();
+    });
+});
+describe('sessionStorage helpers mirror the localStorage ones', () => {
+    it('read / write / remove / clear all target sessionStorage', async () => {
+        const { client, exprs } = stubClient('v');
+        await getSessionStorageKey(client, 'S1', 'k');
+        await setSessionStorageKey(client, 'S1', 'k', 'v');
+        await removeSessionStorageKey(client, 'S1', 'k');
+        await clearSessionStorage(client, 'S1');
+        expect(exprs).toEqual([
+            'sessionStorage.getItem("k")',
+            'sessionStorage.setItem("k", "v")',
+            'sessionStorage.removeItem("k")',
+            'sessionStorage.clear()',
+        ]);
+        expect(exprs.some((e) => e.includes('localStorage'))).toBe(false);
+    });
+    it('getAll parses, and degrades to {} on garbage', async () => {
+        await expect(getAllSessionStorage(stubClient('{"s":"1"}').client, 'S1')).resolves.toEqual({ s: '1' });
+        await expect(getAllSessionStorage(stubClient('<html>').client, 'S1')).resolves.toEqual({});
+    });
+});
+//# sourceMappingURL=storage-eval.test.js.map

package/dist/src/__tests__/storage-eval.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-eval.test.js","sourceRoot":"","sources":["../../../src/__tests__/storage-eval.test.ts"],"names":[],"mappings":"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"}

package/dist/src/__tests__/tabs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tabs.test.d.ts.map

package/dist/src/__tests__/tabs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/tabs.test.ts"],"names":[],"mappings":""}

package/dist/src/__tests__/tabs.test.js

@@ -0,0 +1,161 @@
+/**
+ * tabs.ts — target filtering and the CDP command sequences for
+ * close/activate/frame-switch. Fake fetch + fake client; no browser.
+ */
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import { listTabs, newTab, closeTab, activateTab, switchToFrame } from '../browser/tabs.js';
+const realFetch = globalThis.fetch;
+afterEach(() => {
+    globalThis.fetch = realFetch;
+    vi.restoreAllMocks();
+});
+function stubFetch(body, init = { status: 200 }) {
+    const fn = vi.fn(() => Promise.resolve(new Response(JSON.stringify(body), init)));
+    globalThis.fetch = fn;
+    return fn;
+}
+/** Client stub that records calls and answers from a per-method table. */
+function stubClient(table = {}) {
+    const calls = [];
+    const client = {
+        send: vi.fn(async (method, params, sid) => {
+            calls.push({ method, params, sid });
+            const entry = table[method];
+            if (entry instanceof Error)
+                throw entry;
+            return entry ?? {};
+        }),
+    };
+    return { client, calls };
+}
+describe('listTabs', () => {
+    it('keeps only page targets, dropping service workers, iframes and extensions', async () => {
+        stubFetch([
+            { id: 'A', type: 'page', url: 'https://x.test' },
+            { id: 'B', type: 'service_worker', url: 'https://x.test/sw.js' },
+            { id: 'C', type: 'iframe', url: 'https://ads.test' },
+            { id: 'D', type: 'background_page', url: 'chrome-extension://abc' },
+            { id: 'E', type: 'page', url: 'about:blank' },
+        ]);
+        const tabs = await listTabs(9222);
+        expect(tabs.map((t) => t.id)).toEqual(['A', 'E']);
+    });
+    it('returns [] when Chrome reports no targets at all', async () => {
+        stubFetch([]);
+        await expect(listTabs(9222)).resolves.toEqual([]);
+    });
+    it('propagates a failed /json/list', async () => {
+        globalThis.fetch = vi.fn(() => Promise.resolve(new Response('', { status: 502, statusText: 'Bad Gateway' })));
+        await expect(listTabs(9222)).rejects.toThrow('Failed to fetch targets: Bad Gateway');
+    });
+});
+describe('newTab', () => {
+    it('defaults to about:blank', async () => {
+        const fn = stubFetch({ id: 'T1', type: 'page' });
+        await newTab(9222);
+        expect(fn.mock.calls[0][0]).toBe('http://127.0.0.1:9222/json/new?' + encodeURIComponent('about:blank'));
+    });
+    it('passes an explicit url through, encoded', async () => {
+        const fn = stubFetch({ id: 'T1', type: 'page' });
+        await newTab(9222, 'https://x.test/a b?q=1');
+        expect(fn.mock.calls[0][0]).toContain(encodeURIComponent('https://x.test/a b?q=1'));
+    });
+});
+describe('closeTab', () => {
+    it('sends Target.closeTarget for the given targetId', async () => {
+        const { client, calls } = stubClient();
+        await closeTab(client, 'S1', 'T9');
+        expect(calls).toEqual([{ method: 'Target.closeTarget', params: { targetId: 'T9' }, sid: undefined }]);
+    });
+});
+describe('activateTab', () => {
+    it('detaches the old session, activates, then re-attaches flat and returns the new sessionId', async () => {
+        const { client, calls } = stubClient({ 'Target.attachToTarget': { sessionId: 'S-NEW' } });
+        await expect(activateTab(client, 'S-OLD', 'T9')).resolves.toBe('S-NEW');
+        expect(calls.map((c) => c.method)).toEqual([
+            'Target.detachFromTarget',
+            'Target.activateTarget',
+            'Target.attachToTarget',
+        ]);
+        expect(calls[0].params).toEqual({ sessionId: 'S-OLD' });
+        expect(calls[2].params).toEqual({ targetId: 'T9', flatten: true });
+    });
+    it('skips the detach when there is no previous session', async () => {
+        const { client, calls } = stubClient({ 'Target.attachToTarget': { sessionId: 'S-NEW' } });
+        await activateTab(client, '', 'T9');
+        expect(calls.map((c) => c.method)).toEqual(['Target.activateTarget', 'Target.attachToTarget']);
+    });
+    it('tolerates a detach failure on an already-dead session', async () => {
+        const calls = [];
+        const client = {
+            send: vi.fn(async (method) => {
+                calls.push(method);
+                if (method === 'Target.detachFromTarget')
+                    throw new Error('No session with given id');
+                if (method === 'Target.attachToTarget')
+                    return { sessionId: 'S-NEW' };
+                return {};
+            }),
+        };
+        await expect(activateTab(client, 'S-STALE', 'T9')).resolves.toBe('S-NEW');
+        expect(calls).toContain('Target.activateTarget');
+    });
+});
+describe('switchToFrame', () => {
+    const frameTreeWith = (url) => ({
+        frameTree: { childFrames: [{ frame: { id: 'F1', url, securityOrigin: 'https://f.test' } }] },
+    });
+    it('returns null url when the selector does not resolve to an IFRAME', async () => {
+        const { client, calls } = stubClient({
+            'Runtime.evaluate': { result: { result: { value: null } } },
+            'Page.getFrameTree': { frameTree: {} },
+        });
+        await expect(switchToFrame(client, 'S1', 'div.not-a-frame')).resolves.toEqual({ url: null, sessionId: null });
+        // The selector is embedded as a JSON string literal, never interpolated raw.
+        const expr = calls[0].params.expression;
+        expect(expr).toContain('document.querySelector("div.not-a-frame")');
+    });
+    it('JSON-escapes a selector containing quotes rather than breaking the expression', async () => {
+        const { client, calls } = stubClient({
+            'Runtime.evaluate': { result: { result: { value: null } } },
+            'Page.getFrameTree': { frameTree: {} },
+        });
+        await switchToFrame(client, 'S1', 'iframe[title="a\\"b"]');
+        const expr = calls[0].params.expression;
+        expect(expr).toContain(JSON.stringify('iframe[title="a\\"b"]'));
+    });
+    it('returns the frame src with null sessionId when no OOPIF target matches', async () => {
+        const { client, calls } = stubClient({
+            'Runtime.evaluate': { result: { result: { value: 'https://f.test/frame' } } },
+            'Page.getFrameTree': frameTreeWith('https://f.test/frame'),
+            'Target.getTargets': { targetInfos: [{ targetId: 'T1', type: 'page', url: 'https://x.test' }] },
+        });
+        await expect(switchToFrame(client, 'S1', 'iframe')).resolves.toEqual({ url: 'https://f.test/frame', sessionId: null });
+        expect(calls.map((c) => c.method)).not.toContain('Target.attachToTarget');
+    });
+    it('attaches flat to a matching OOPIF target and returns its sessionId', async () => {
+        const { client, calls } = stubClient({
+            'Runtime.evaluate': { result: { result: { value: 'https://f.test/frame' } } },
+            'Page.getFrameTree': frameTreeWith('https://f.test/frame'),
+            'Target.getTargets': {
+                targetInfos: [
+                    { targetId: 'T-PAGE', type: 'page', url: 'https://f.test/frame' },
+                    { targetId: 'T-OOPIF', type: 'iframe', url: 'https://f.test/frame' },
+                ],
+            },
+            'Target.attachToTarget': { sessionId: 'S-FRAME' },
+        });
+        await expect(switchToFrame(client, 'S1', 'iframe')).resolves.toEqual({ url: 'https://f.test/frame', sessionId: 'S-FRAME' });
+        const attach = calls.find((c) => c.method === 'Target.attachToTarget');
+        expect(attach.params).toEqual({ targetId: 'T-OOPIF', flatten: true });
+    });
+    it('returns the src with null sessionId when the frame tree has no match', async () => {
+        const { client, calls } = stubClient({
+            'Runtime.evaluate': { result: { result: { value: 'https://f.test/frame' } } },
+            'Page.getFrameTree': frameTreeWith('https://other.test/elsewhere'),
+        });
+        await expect(switchToFrame(client, 'S1', 'iframe')).resolves.toEqual({ url: 'https://f.test/frame', sessionId: null });
+        expect(calls.map((c) => c.method)).not.toContain('Target.getTargets');
+    });
+});
+//# sourceMappingURL=tabs.test.js.map

package/dist/src/__tests__/tabs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.test.js","sourceRoot":"","sources":["../../../src/__tests__/tabs.test.ts"],"names":[],"mappings":"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"}

package/dist/src/browser/browser.d.ts

@@ -1,5 +1,9 @@
 import { CdpClient } from './cdp.js';
 import type { BrowserConfig, CdpTarget } from './types.js';
+/** PID of the Chrome instance *this process* launched on `port`, if any. */
+export declare function getLaunchedPid(port: number): number | undefined;
+/** userDataDir of the Chrome instance *this process* launched on `port`, if any. */
+export declare function getLaunchedUserDataDir(port: number): string | undefined;
 export declare function isPortOpen(port: number): Promise<boolean>;
 export declare function launchBrowser(config?: BrowserConfig): Promise<number>;
 export declare function enableSessionDomains(client: CdpClient, sessionId: string): Promise<void>;

package/dist/src/browser/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser/browser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAsC3D,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AA2CD,wBAAsB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD/E;AAiED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B3I;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCjF;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9F;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,GAAG,aAAa,GAAG,kBAA2B,EAC/D,OAAO,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAgED,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMzF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3F"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/browser/browser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAgC,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAwB3D,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAuBD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AA2CD,wBAAsB,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD/E;AAqED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9F;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B3I;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEjF;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9F;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,GAAG,aAAa,GAAG,kBAA2B,EAC/D,OAAO,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAgED,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMzF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3F"}

package/dist/src/browser/browser.js

@@ -7,16 +7,31 @@ import { CdpClient, fetchTargets, fetchNewTarget } from './cdp.js';
 import { CHROME_EXECUTABLES } from './types.js';
 import { enableConsoleCapture, setupConsoleCapture } from './console-log.js';
 import { setupDialogAutoHandling } from './dialog.js';
+import { loadActivePortInfo } from './ref-cache.js';
 const DEFAULT_PORT = 9222;
 const LAUNCH_TIMEOUT = 10_000;
 const POLL_INTERVAL = 200;
 const BROWSER_CLOSE_TIMEOUT_MS = 3000;
+// A cross-process persisted PID older than this is not trusted for the
+// SIGKILL fallback in closeBrowser() — see the call site for why.
+const PERSISTED_PID_MAX_AGE_MS = 24 * 60 * 60 * 1000;
 // Tracks the PID of Chrome instances *we* spawned, keyed by CDP port, so
 // closeBrowser() has a kill fallback when the graceful `Browser.close` CDP
 // command fails or times out (e.g. a hung renderer). Ports we merely attached
 // to (already-running browser) are never recorded here — we only ever kill
 // processes we launched ourselves.
 const launchedPids = new Map();
+// userDataDir per launched port — informational, persisted alongside the pid
+// so a later process could clean up the temp profile dir too if ever needed.
+const launchedUserDataDirs = new Map();
+/** PID of the Chrome instance *this process* launched on `port`, if any. */
+export function getLaunchedPid(port) {
+    return launchedPids.get(port);
+}
+/** userDataDir of the Chrome instance *this process* launched on `port`, if any. */
+export function getLaunchedUserDataDir(port) {
+    return launchedUserDataDirs.get(port);
+}
 function findChrome(executablePath) {
     if (executablePath) {
         if (existsSync(executablePath))
@@ -174,9 +189,12 @@ async function launchOnFreePort(config, port) {
         stdio: 'ignore',
     });
     child.unref();
-    if (child.pid)
+    if (child.pid) {
         launchedPids.set(port, child.pid);
-    const deadline = Date.now() + LAUNCH_TIMEOUT;
+        launchedUserDataDirs.set(port, userDataDir);
+    }
+    const launchTimeout = config.launchTimeoutMs ?? LAUNCH_TIMEOUT;
+    const deadline = Date.now() + launchTimeout;
     while (Date.now() < deadline) {
         await sleep(POLL_INTERVAL);
         if (await isPortOpen(port)) {
@@ -190,10 +208,10 @@ async function launchOnFreePort(config, port) {
     // "nothing is listening" (real launch failure) from "something non-CDP is
     // squatting the port" (confusing generic timeout otherwise) via a raw TCP probe.
     if (await isTcpPortOpen(port)) {
-        throw new Error(`Port ${port} is occupied by a non-Chrome process (TCP connection succeeds but no CDP response within ${LAUNCH_TIMEOUT}ms). ` +
+        throw new Error(`Port ${port} is occupied by a non-Chrome process (TCP connection succeeds but no CDP response within ${launchTimeout}ms). ` +
             `Free the port or pass a different one.`);
     }
-    throw new Error(`Chrome failed to start on port ${port} within ${LAUNCH_TIMEOUT}ms`);
+    throw new Error(`Chrome failed to start on port ${port} within ${launchTimeout}ms`);
 }
 export async function enableSessionDomains(client, sessionId) {
     await Promise.all([
@@ -257,15 +275,45 @@ export async function closeBrowser(client, port) {
     catch {
         // fall through to PID-kill fallback below
     }
-    const pid = launchedPids.get(port);
+    let pid = launchedPids.get(port);
+    if (pid === undefined) {
+        // Fresh process (each CLI invocation is its own node process — see
+        // module header) — launchedPids is per-process and empty here even
+        // though a prior `open` in a DIFFERENT process launched this Chrome.
+        // Fall back to the PID that process persisted via saveActivePort().
+        try {
+            const persisted = await loadActivePortInfo();
+            if (persisted && persisted.port === port && persisted.launched && persisted.pid) {
+                // Bound how far we trust a cross-process PID: if the Chrome we
+                // launched died outside this flow (OOM-killed, host slept, etc.)
+                // without active-port.json ever being cleared, the OS can recycle
+                // that PID for an unrelated process. There is no cmdline/start-time
+                // check available portably, so a coarse age bound is the practical
+                // guard — a PID persisted more than a day ago is far more likely to
+                // be stale/reused than to still be the same live Chrome.
+                const age = persisted.savedAt !== undefined ? Date.now() - persisted.savedAt : undefined;
+                if (age === undefined || age <= PERSISTED_PID_MAX_AGE_MS) {
+                    pid = persisted.pid;
+                }
+            }
+        }
+        catch {
+            // best-effort — fall through to "nothing to kill" below
+        }
+    }
     if (pid === undefined)
-        return; // not a process we launched — nothing to kill
+        return; // not a process we launched, or too stale to trust — nothing to kill
     launchedPids.delete(port);
+    // Liveness-check before every SIGKILL (not just the safety-net path below)
+    // — process.kill(pid, 0) throws ESRCH if the PID is no longer running,
+    // which also catches the case where the PID has already been recycled by
+    // an unrelated process that happens to have exited too.
     if (!gracefullyClosed) {
         try {
+            process.kill(pid, 0);
             process.kill(pid, 'SIGKILL');
         }
-        catch { /* already exited */ }
+        catch { /* already exited, or never was — nothing to do */ }
         return;
     }
     // Browser.close was acknowledged — give the process a moment to exit on