browserclaw 0.3.9 → 0.3.10

package/dist/index.cjs

@@ -382,6 +382,51 @@ async function getChromeWebSocketUrl(cdpUrl, timeoutMs = 500, authToken) {
     clearTimeout(t);
   }
 }
+async function isChromeCdpReady(cdpUrl, timeoutMs = 500, handshakeTimeoutMs = 800) {
+  const wsUrl = await getChromeWebSocketUrl(cdpUrl, timeoutMs);
+  if (!wsUrl) return false;
+  return await canRunCdpHealthCommand(wsUrl, handshakeTimeoutMs);
+}
+async function canRunCdpHealthCommand(wsUrl, timeoutMs = 800) {
+  return new Promise((resolve2) => {
+    let settled = false;
+    const finish = (value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      try {
+        ws.close();
+      } catch {
+      }
+      resolve2(value);
+    };
+    const timer = setTimeout(() => finish(false), Math.max(50, timeoutMs + 25));
+    let ws;
+    try {
+      ws = new WebSocket(wsUrl);
+    } catch {
+      finish(false);
+      return;
+    }
+    ws.onopen = () => {
+      try {
+        ws.send(JSON.stringify({ id: 1, method: "Browser.getVersion" }));
+      } catch {
+        finish(false);
+      }
+    };
+    ws.onmessage = (event) => {
+      try {
+        const parsed = JSON.parse(String(event.data));
+        if (parsed?.id !== 1) return;
+        finish(Boolean(parsed.result && typeof parsed.result === "object"));
+      } catch {
+      }
+    };
+    ws.onerror = () => finish(false);
+    ws.onclose = () => finish(false);
+  });
+}
 async function launchChrome(opts = {}) {
   const cdpPort = opts.cdpPort ?? DEFAULT_CDP_PORT;
   await ensurePortAvailable(cdpPort);
@@ -456,18 +501,30 @@ async function launchChrome(opts = {}) {
   }
   const proc = spawnChrome();
   const cdpUrl = `http://127.0.0.1:${cdpPort}`;
+  const stderrChunks = [];
+  const onStderr = (chunk) => {
+    stderrChunks.push(chunk);
+  };
+  proc.stderr?.on("data", onStderr);
   const readyDeadline = Date.now() + 15e3;
   while (Date.now() < readyDeadline) {
     if (await isChromeReachable(cdpUrl, 500)) break;
     await new Promise((r) => setTimeout(r, 200));
   }
   if (!await isChromeReachable(cdpUrl, 500)) {
+    const stderrOutput = Buffer.concat(stderrChunks).toString("utf8").trim();
+    const stderrHint = stderrOutput ? `
+Chrome stderr:
+${stderrOutput.slice(0, 2e3)}` : "";
+    const sandboxHint = process.platform === "linux" && !opts.noSandbox ? "\nHint: If running in a container or as root, try setting noSandbox: true." : "";
     try {
       proc.kill("SIGKILL");
     } catch {
     }
-    throw new Error(`Failed to start Chrome CDP on port ${cdpPort}. Chrome may not have started correctly.`);
+    throw new Error(`Failed to start Chrome CDP on port ${cdpPort}.${sandboxHint}${stderrHint}`);
   }
+  proc.stderr?.off("data", onStderr);
+  stderrChunks.length = 0;
   return {
     pid: proc.pid ?? -1,
     exe,
@@ -3195,6 +3252,7 @@ exports.BrowserClaw = BrowserClaw;
 exports.CrawlPage = CrawlPage;
 exports.InvalidBrowserNavigationUrlError = InvalidBrowserNavigationUrlError;
 exports.assertBrowserNavigationAllowed = assertBrowserNavigationAllowed;
+exports.isChromeCdpReady = isChromeCdpReady;
 exports.withBrowserNavigationPolicy = withBrowserNavigationPolicy;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map