chrome-devtools-mcp 0.12.0 → 0.13.0

package/README.md

@@ -91,10 +91,10 @@ Chrome DevTools MCP will not start the browser instance automatically using this
 
 <details>
   <summary>Claude Code</summary>
-    Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp">guide</a>):
+    Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://code.claude.com/docs/en/mcp">guide</a>):
 
 ```bash
-claude mcp add chrome-devtools npx chrome-devtools-mcp@latest
+claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
 ```
 
 </details>
@@ -160,9 +160,9 @@ Configure the following fields and press `CTRL+S` to save the configuration:
 
 **Click the button to install:**
 
-[<img src="https://mcpbadge.dev/badge-install-in-vs-code-stable-dark" alt="Install in VS Code">](https://vscode.dev/redirect/mcp/install?name=io.github.ChromeDevTools%2Fchrome-devtools-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22chrome-devtools-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
+[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://vscode.dev/redirect/mcp/install?name=io.github.ChromeDevTools%2Fchrome-devtools-mcp&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22chrome-devtools-mcp%22%5D%2C%22env%22%3A%7B%7D%7D)
 
-[<img src="https://mcpbadge.dev/badge-install-in-vs-code-insiders-dark" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522io.github.ChromeDevTools%252Fchrome-devtools-mcp%2522%252C%2522config%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522chrome-devtools-mcp%2522%255D%252C%2522env%2522%253A%257B%257D%257D%257D)
+[<img src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522io.github.ChromeDevTools%252Fchrome-devtools-mcp%2522%252C%2522config%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522chrome-devtools-mcp%2522%255D%252C%2522env%2522%253A%257B%257D%257D%257D)
 
 **Or install manually:**
 
@@ -241,6 +241,25 @@ Or, from the IDE **Activity Bar** > `Kiro` > `MCP Servers` > `Click Open MCP Con
 
 </details>
 
+<details>
+  <summary>OpenCode</summary>
+
+Add the following configuration to your `opencode.json` file. If you don't have one, create it at `~/.config/opencode/opencode.json` (<a href="https://opencode.ai/docs/mcp-servers">guide</a>):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "chrome-devtools": {
+      "type": "local",
+      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
+```
+
+</details>
+
 <details>
   <summary>Qoder</summary>
 
@@ -350,20 +369,20 @@ The Chrome DevTools MCP server supports the following configuration option:
 
 <!-- BEGIN AUTO GENERATED OPTIONS -->
 
-- **`--autoConnect`**
+- **`--autoConnect`/ `--auto-connect`**
   If specified, automatically connects to a browser (Chrome 145+) running in the user data directory identified by the channel param. Requires remote debugging being enabled in Chrome here: chrome://inspect/#remote-debugging.
   - **Type:** boolean
   - **Default:** `false`
 
-- **`--browserUrl`, `-u`**
+- **`--browserUrl`/ `--browser-url`, `-u`**
   Connect to a running, debuggable Chrome instance (e.g. `http://127.0.0.1:9222`). For more details see: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.
   - **Type:** string
 
-- **`--wsEndpoint`, `-w`**
+- **`--wsEndpoint`/ `--ws-endpoint`, `-w`**
   WebSocket endpoint to connect to a running Chrome instance (e.g., ws://127.0.0.1:9222/devtools/browser/<id>). Alternative to --browserUrl.
   - **Type:** string
 
-- **`--wsHeaders`**
+- **`--wsHeaders`/ `--ws-headers`**
   Custom headers for WebSocket connection in JSON format (e.g., '{"Authorization":"Bearer token"}'). Only works with --wsEndpoint.
   - **Type:** string
 
@@ -372,7 +391,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `false`
 
-- **`--executablePath`, `-e`**
+- **`--executablePath`/ `--executable-path`, `-e`**
   Path to custom Chrome executable.
   - **Type:** string
 
@@ -380,7 +399,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to false.
   - **Type:** boolean
 
-- **`--userDataDir`**
+- **`--userDataDir`/ `--user-data-dir`**
   Path to the user data directory for Chrome. Default is $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE
   - **Type:** string
 
@@ -389,7 +408,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** string
   - **Choices:** `stable`, `canary`, `beta`, `dev`
 
-- **`--logFile`**
+- **`--logFile`/ `--log-file`**
   Path to a file to write debug logs to. Set the env variable `DEBUG` to `*` to enable verbose logs. Useful for submitting bug reports.
   - **Type:** string
 
@@ -397,29 +416,33 @@ The Chrome DevTools MCP server supports the following configuration option:
   Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.
   - **Type:** string
 
-- **`--proxyServer`**
+- **`--proxyServer`/ `--proxy-server`**
   Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.
   - **Type:** string
 
-- **`--acceptInsecureCerts`**
+- **`--acceptInsecureCerts`/ `--accept-insecure-certs`**
   If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.
   - **Type:** boolean
 
-- **`--chromeArg`**
+- **`--chromeArg`/ `--chrome-arg`**
   Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
   - **Type:** array
 
-- **`--categoryEmulation`**
+- **`--ignoreDefaultChromeArg`/ `--ignore-default-chrome-arg`**
+  Explicitly disable default arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
+  - **Type:** array
+
+- **`--categoryEmulation`/ `--category-emulation`**
   Set to false to exclude tools related to emulation.
   - **Type:** boolean
   - **Default:** `true`
 
-- **`--categoryPerformance`**
+- **`--categoryPerformance`/ `--category-performance`**
   Set to false to exclude tools related to performance.
   - **Type:** boolean
   - **Default:** `true`
 
-- **`--categoryNetwork`**
+- **`--categoryNetwork`/ `--category-network`**
   Set to false to exclude tools related to network.
   - **Type:** boolean
   - **Default:** `true`
@@ -484,9 +507,70 @@ the browser is closed.
 
 ### Connecting to a running Chrome instance
 
-You can connect to a running Chrome instance by using the `--browser-url` option. This is useful if you want to use your existing Chrome profile or if you are running the MCP server in a sandboxed environment that does not allow starting a new Chrome instance.
+By default, the Chrome DevTools MCP server will start a new Chrome instance with a dedicated profile. This might not be ideal in all situations:
+
+- If you would like to maintain the same application state when alternating between manual site testing and agent-driven testing.
+- When the MCP needs to sign into a website. Some accounts may prevent sign-in when the browser is controlled via WebDriver (the default launch mechanism for the Chrome DevTools MCP server).
+- If you're running your LLM inside a sandboxed environment, but you would like to connect to a Chrome instance that runs outside the sandbox.
+
+In these cases, start Chrome first and let the Chrome DevTools MCP server connect to it. There are two ways to do so:
+
+- **Automatic connection (available in Chrome 144)**: best for sharing state between manual and agent-driven testing.
+- **Manual connection via remote debugging port**: best when running inside a sandboxed environment.
+
+#### Automatically connecting to a running Chrome instance
+
+**Step 1:** Set up remote debugging in Chrome
+
+In Chrome (\>= M144), do the following to set up remote debugging:
+
+1.  Navigate to `chrome://inspect/#remote-debugging` to enable remote debugging.
+2.  Follow the dialog UI to allow or disallow incoming debugging connections.
+
+**Step 2:** Configure Chrome DevTools MCP server to automatically connect to a running Chrome Instance
+
+To connect the `chrome-devtools-mcp` server to the running Chrome instance, use
+`--autoConnect` command line argument for the MCP server.
+
+The following code snippet is an example configuration for gemini-cli:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["chrome-devtools-mcp@latest", "--autoConnect", "--channel=beta"]
+    }
+  }
+}
+```
+
+Note: you have to specify `--channel=beta` until Chrome M144 has reached the
+stable channel.
+
+**Step 3:** Test your setup
+
+Make sure your browser is running. Open gemini-cli and run the following prompt:
+
+```none
+Check the performance of https://developers.chrome.com
+```
+
+> [!NOTE]  
+> The <code>autoConnect</code> option requires the user to start Chrome. If the user has multiple active profiles, the MCP server will connect to the default profile (as determined by Chrome). The MCP server has access to all open windows for the selected profile.
+
+The Chrome DevTools MCP server will try to connect to your running Chrome
+instance. It shows a dialog asking for user permission.
+
+Clicking **Allow** results in the Chrome DevTools MCP server opening
+[developers.chrome.com](http://developers.chrome.com) and taking a performance
+trace.
+
+#### Manual connection using port forwarding
+
+You can connect to a running Chrome instance by using the `--browser-url` option. This is useful if you are running the MCP server in a sandboxed environment that does not allow starting a new Chrome instance.
 
-Here is a step-by-step guide on how to connect to a running Chrome Stable instance:
+Here is a step-by-step guide on how to connect to a running Chrome instance:
 
 **Step 1: Configure the MCP client**
 

package/build/src/DevtoolsUtils.js

@@ -3,11 +3,11 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { DebuggerModel, Foundation, TargetManager, MarkdownIssueDescription, Marked, ProtocolClient, Common, I18n, } from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 import { PuppeteerDevToolsConnection } from './DevToolsConnectionAdapter.js';
 import { ISSUE_UTILS } from './issue-descriptions.js';
 import { logger } from './logger.js';
 import { Mutex } from './Mutex.js';
+import { DevTools } from './third_party/index.js';
 export function extractUrlLikeFromDevToolsTitle(title) {
     const match = title.match(new RegExp(`DevTools - (.*)`));
     return match?.[1] ?? undefined;
@@ -58,7 +58,7 @@ function normalizeUrl(url) {
  * A mock implementation of an issues manager that only implements the methods
  * that are actually used by the IssuesAggregator
  */
-export class FakeIssuesManager extends Common.ObjectWrapper
+export class FakeIssuesManager extends DevTools.Common.ObjectWrapper
     .ObjectWrapper {
     issues() {
         return [];
@@ -82,9 +82,11 @@ export function mapIssueToMessageObject(issue) {
     let processedMarkdown;
     let title;
     try {
-        processedMarkdown = MarkdownIssueDescription.substitutePlaceholders(rawMarkdown, markdownDescription.substitutions);
-        const markdownAst = Marked.Marked.lexer(processedMarkdown);
-        title = MarkdownIssueDescription.findTitleFromMarkdownAst(markdownAst);
+        processedMarkdown =
+            DevTools.MarkdownIssueDescription.substitutePlaceholders(rawMarkdown, markdownDescription.substitutions);
+        const markdownAst = DevTools.Marked.Marked.lexer(processedMarkdown);
+        title =
+            DevTools.MarkdownIssueDescription.findTitleFromMarkdownAst(markdownAst);
     }
     catch {
         logger('error parsing markdown for issue ' + issue.code());
@@ -103,8 +105,8 @@ export function mapIssueToMessageObject(issue) {
     };
 }
 // DevTools CDP errors can get noisy.
-ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
-I18n.DevToolsLocale.DevToolsLocale.instance({
+DevTools.ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
+DevTools.I18n.DevToolsLocale.DevToolsLocale.instance({
     create: true,
     data: {
         navigatorLanguage: 'en-US',
@@ -112,7 +114,7 @@ I18n.DevToolsLocale.DevToolsLocale.instance({
         lookupClosestDevToolsLocale: l => l,
     },
 });
-I18n.i18n.registerLocaleDataForTest('en-US', {});
+DevTools.I18n.i18n.registerLocaleDataForTest('en-US', {});
 export class UniverseManager {
     #browser;
     #createUniverseFor;
@@ -173,20 +175,20 @@ export class UniverseManager {
     };
 }
 const DEFAULT_FACTORY = async (page) => {
-    const settingStorage = new Common.Settings.SettingsStorage({});
-    const universe = new Foundation.Universe.Universe({
+    const settingStorage = new DevTools.Common.Settings.SettingsStorage({});
+    const universe = new DevTools.Foundation.Universe.Universe({
         settingsCreationOptions: {
             syncedStorage: settingStorage,
             globalStorage: settingStorage,
             localStorage: settingStorage,
-            settingRegistrations: Common.SettingRegistration.getRegisteredSettings(),
+            settingRegistrations: DevTools.Common.SettingRegistration.getRegisteredSettings(),
         },
-        overrideAutoStartModels: new Set([DebuggerModel]),
+        overrideAutoStartModels: new Set([DevTools.DebuggerModel]),
     });
     const session = await page.createCDPSession();
     const connection = new PuppeteerDevToolsConnection(session);
-    const targetManager = universe.context.get(TargetManager);
-    targetManager.observeModels(DebuggerModel, SKIP_ALL_PAUSES);
+    const targetManager = universe.context.get(DevTools.TargetManager);
+    targetManager.observeModels(DevTools.DebuggerModel, SKIP_ALL_PAUSES);
     const target = targetManager.createTarget('main', '', 'frame', // eslint-disable-line @typescript-eslint/no-explicit-any
     /* parentTarget */ null, session.id(), undefined, connection);
     return { target, universe };

package/build/src/McpContext.js

@@ -56,6 +56,8 @@ export class McpContext {
     #cpuThrottlingRateMap = new WeakMap();
     #geolocationMap = new WeakMap();
     #dialog;
+    #pageIdMap = new WeakMap();
+    #nextPageId = 1;
     #nextSnapshotId = 1;
     #traceResults = [];
     #locatorClass;
@@ -163,11 +165,11 @@ export class McpContext {
         this.#consoleCollector.addPage(page);
         return page;
     }
-    async closePage(pageIdx) {
+    async closePage(pageId) {
         if (this.#pages.length === 1) {
             throw new Error(CLOSE_PAGE_ERROR);
         }
-        const page = this.getPageByIdx(pageIdx);
+        const page = this.getPageById(pageId);
         await page.close({ runBeforeUnload: false });
     }
     getNetworkRequestById(reqid) {
@@ -231,14 +233,16 @@ export class McpContext {
         }
         return page;
     }
-    getPageByIdx(idx) {
-        const pages = this.#pages;
-        const page = pages[idx];
+    getPageById(pageId) {
+        const page = this.#pages.find(p => this.#pageIdMap.get(p) === pageId);
         if (!page) {
             throw new Error('No page found');
         }
         return page;
     }
+    getPageId(page) {
+        return this.#pageIdMap.get(page);
+    }
     #dialogHandler = (dialog) => {
         this.#dialog = dialog;
     };
@@ -249,10 +253,16 @@ export class McpContext {
         const oldPage = this.#selectedPage;
         if (oldPage) {
             oldPage.off('dialog', this.#dialogHandler);
+            void oldPage.emulateFocusedPage(false).catch(error => {
+                this.logger('Error turning off focused page emulation', error);
+            });
         }
         this.#selectedPage = newPage;
         newPage.on('dialog', this.#dialogHandler);
         this.#updateSelectedPageTimeouts();
+        void newPage.emulateFocusedPage(true).catch(error => {
+            this.logger('Error turning on focused page emulation', error);
+        });
     }
     #updateSelectedPageTimeouts() {
         const page = this.getSelectedPage();
@@ -296,6 +306,11 @@ export class McpContext {
      */
     async createPagesSnapshot() {
         const allPages = await this.browser.pages(this.#options.experimentalIncludeAllPages);
+        for (const page of allPages) {
+            if (!this.#pageIdMap.has(page)) {
+                this.#pageIdMap.set(page, this.#nextPageId++);
+            }
+        }
         this.#pages = allPages.filter(page => {
             // If we allow debugging DevTools windows, return all pages.
             // If we are in regular mode, the user should only see non-DevTools page.

package/build/src/McpResponse.js

@@ -3,11 +3,11 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { AggregatedIssue } from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 import { mapIssueToMessageObject } from './DevtoolsUtils.js';
 import { formatConsoleEventShort, formatConsoleEventVerbose, } from './formatters/consoleFormatter.js';
 import { getFormattedHeaderValue, getFormattedResponseBody, getFormattedRequestBody, getShortDescriptionForRequest, getStatusFromRequest, } from './formatters/networkFormatter.js';
-import { formatSnapshotNode } from './formatters/snapshotFormatter.js';
+import { SnapshotFormatter } from './formatters/SnapshotFormatter.js';
+import { DevTools } from './third_party/index.js';
 import { handleDialog } from './tools/pages.js';
 import { paginate } from './utils/pagination.js';
 export class McpResponse {
@@ -20,9 +20,13 @@ export class McpResponse {
     #networkRequestsOptions;
     #consoleDataOptions;
     #devToolsData;
+    #tabId;
     attachDevToolsData(data) {
         this.#devToolsData = data;
     }
+    setTabId(tabId) {
+        this.#tabId = tabId;
+    }
     setIncludePages(value) {
         this.#includePages = value;
     }
@@ -112,17 +116,18 @@ export class McpResponse {
         if (this.#includePages) {
             await context.createPagesSnapshot();
         }
-        let formattedSnapshot;
+        let snapshot;
         if (this.#snapshotParams) {
             await context.createTextSnapshot(this.#snapshotParams.verbose, this.#devToolsData);
-            const snapshot = context.getTextSnapshot();
-            if (snapshot) {
+            const textSnapshot = context.getTextSnapshot();
+            if (textSnapshot) {
+                const formatter = new SnapshotFormatter(textSnapshot);
                 if (this.#snapshotParams.filePath) {
-                    await context.saveFile(new TextEncoder().encode(formatSnapshotNode(snapshot.root, snapshot)), this.#snapshotParams.filePath);
-                    formattedSnapshot = `Saved snapshot to ${this.#snapshotParams.filePath}.`;
+                    await context.saveFile(new TextEncoder().encode(formatter.toString()), this.#snapshotParams.filePath);
+                    snapshot = this.#snapshotParams.filePath;
                 }
                 else {
-                    formattedSnapshot = formatSnapshotNode(snapshot.root, snapshot);
+                    snapshot = formatter;
                 }
             }
         }
@@ -155,10 +160,11 @@ export class McpResponse {
                     })),
                 };
             }
-            else if (message instanceof AggregatedIssue) {
+            else if (message instanceof DevTools.AggregatedIssue) {
                 const mappedIssueMessage = mapIssueToMessageObject(message);
-                if (!mappedIssueMessage)
+                if (!mappedIssueMessage) {
                     throw new Error("Can't provide detals for the msgid " + consoleMessageStableId);
+                }
                 consoleData = {
                     consoleMessageStableId,
                     ...mappedIssueMessage,
@@ -182,7 +188,7 @@ export class McpResponse {
                     if ('type' in message) {
                         return normalizedTypes.has(message.type());
                     }
-                    if (message instanceof AggregatedIssue) {
+                    if (message instanceof DevTools.AggregatedIssue) {
                         return normalizedTypes.has('issue');
                     }
                     return normalizedTypes.has('error');
@@ -206,10 +212,11 @@ export class McpResponse {
                         })),
                     };
                 }
-                if (item instanceof AggregatedIssue) {
+                if (item instanceof DevTools.AggregatedIssue) {
                     const mappedIssueMessage = mapIssueToMessageObject(item);
-                    if (!mappedIssueMessage)
+                    if (!mappedIssueMessage) {
                         return null;
+                    }
                     return {
                         consoleMessageStableId,
                         ...mappedIssueMessage,
@@ -227,7 +234,7 @@ export class McpResponse {
             bodies,
             consoleData,
             consoleListData,
-            formattedSnapshot,
+            snapshot,
         });
     }
     format(toolName, context, data) {
@@ -257,16 +264,25 @@ Call ${handleDialog.name} to handle it before continuing.`);
         }
         if (this.#includePages) {
             const parts = [`## Pages`];
-            let idx = 0;
             for (const page of context.getPages()) {
-                parts.push(`${idx}: ${page.url()}${context.isPageSelected(page) ? ' [selected]' : ''}`);
-                idx++;
+                parts.push(`${context.getPageId(page)}: ${page.url()}${context.isPageSelected(page) ? ' [selected]' : ''}`);
             }
             response.push(...parts);
         }
-        if (data.formattedSnapshot) {
-            response.push('## Latest page snapshot');
-            response.push(data.formattedSnapshot);
+        const structuredContent = {};
+        if (this.#tabId) {
+            structuredContent.tabId = this.#tabId;
+        }
+        if (data.snapshot) {
+            if (typeof data.snapshot === 'string') {
+                response.push(`Saved snapshot to ${data.snapshot}.`);
+                structuredContent.snapshotFilePath = data.snapshot;
+            }
+            else {
+                response.push('## Latest page snapshot');
+                response.push(data.snapshot.toString());
+                structuredContent.snapshot = data.snapshot.toJSON();
+            }
         }
         response.push(...this.#formatNetworkRequestData(context, data.bodies));
         response.push(...this.#formatConsoleData(context, data.consoleData));
@@ -315,7 +331,10 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 ...imageData,
             };
         });
-        return [text, ...images];
+        return {
+            content: [text, ...images],
+            structuredContent,
+        };
     }
     #dataWithPagination(data, pagination) {
         const response = [];

package/build/src/PageCollector.js

@@ -3,9 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { createIssuesFromProtocolIssue, IssueAggregator, } from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 import { FakeIssuesManager } from './DevtoolsUtils.js';
 import { logger } from './logger.js';
+import { DevTools } from './third_party/index.js';
 function createIdGenerator() {
     let i = 1;
     return () => {
@@ -43,18 +43,28 @@ export class PageCollector {
         this.#browser.off('targetdestroyed', this.#onTargetDestroyed);
     }
     #onTargetCreated = async (target) => {
-        const page = await target.page();
-        if (!page) {
-            return;
+        try {
+            const page = await target.page();
+            if (!page) {
+                return;
+            }
+            this.addPage(page);
+        }
+        catch (err) {
+            logger('Error getting a page for a target onTargetCreated', err);
         }
-        this.addPage(page);
     };
     #onTargetDestroyed = async (target) => {
-        const page = await target.page();
-        if (!page) {
-            return;
+        try {
+            const page = await target.page();
+            if (!page) {
+                return;
+            }
+            this.cleanupPageDestroyed(page);
+        }
+        catch (err) {
+            logger('Error getting a page for a target onTargetDestroyed', err);
         }
-        this.cleanupPageDestroyed(page);
     };
     addPage(page) {
         this.#initializePage(page);
@@ -164,7 +174,7 @@ export class ConsoleCollector extends PageCollector {
 }
 class PageIssueSubscriber {
     #issueManager = new FakeIssuesManager();
-    #issueAggregator = new IssueAggregator(this.#issueManager);
+    #issueAggregator = new DevTools.IssueAggregator(this.#issueManager);
     #seenKeys = new Set();
     #seenIssues = new Set();
     #page;
@@ -177,10 +187,10 @@ class PageIssueSubscriber {
     #resetIssueAggregator() {
         this.#issueManager = new FakeIssuesManager();
         if (this.#issueAggregator) {
-            this.#issueAggregator.removeEventListener("AggregatedIssueUpdated" /* IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
+            this.#issueAggregator.removeEventListener("AggregatedIssueUpdated" /* DevTools.IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
         }
-        this.#issueAggregator = new IssueAggregator(this.#issueManager);
-        this.#issueAggregator.addEventListener("AggregatedIssueUpdated" /* IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
+        this.#issueAggregator = new DevTools.IssueAggregator(this.#issueManager);
+        this.#issueAggregator.addEventListener("AggregatedIssueUpdated" /* DevTools.IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
     }
     async subscribe() {
         this.#resetIssueAggregator();
@@ -199,7 +209,7 @@ class PageIssueSubscriber {
         this.#page.off('framenavigated', this.#onFrameNavigated);
         this.#session.off('Audits.issueAdded', this.#onIssueAdded);
         if (this.#issueAggregator) {
-            this.#issueAggregator.removeEventListener("AggregatedIssueUpdated" /* IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
+            this.#issueAggregator.removeEventListener("AggregatedIssueUpdated" /* DevTools.IssueAggregatorEvents.AGGREGATED_ISSUE_UPDATED */, this.#onAggregatedissue);
         }
         void this.#session.send('Audits.disable').catch(() => {
             // might fail.
@@ -225,9 +235,9 @@ class PageIssueSubscriber {
     #onIssueAdded = (data) => {
         try {
             const inspectorIssue = data.issue;
-            // @ts-expect-error Types of protocol from Puppeteer and CDP are
-            // incomparable for InspectorIssueCode, one is union, other is enum.
-            const issue = createIssuesFromProtocolIssue(null, inspectorIssue)[0];
+            const issue = DevTools.createIssuesFromProtocolIssue(null, 
+            // @ts-expect-error Protocol types diverge.
+            inspectorIssue)[0];
             if (!issue) {
                 logger('No issue mapping for for the issue: ', inspectorIssue.code);
                 return;
@@ -237,7 +247,7 @@ class PageIssueSubscriber {
                 return;
             }
             this.#seenKeys.add(primaryKey);
-            this.#issueManager.dispatchEventToListeners("IssueAdded" /* IssuesManagerEvents.ISSUE_ADDED */, {
+            this.#issueManager.dispatchEventToListeners("IssueAdded" /* DevTools.IssuesManagerEvents.ISSUE_ADDED */, {
                 issue,
                 // @ts-expect-error We don't care that issues model is null
                 issuesModel: null,

package/build/src/browser.js

@@ -116,9 +116,10 @@ export async function launch(options) {
         });
     }
     const args = [
-        ...(options.args ?? []),
+        ...(options.chromeArgs ?? []),
         '--hide-crash-restore-bubble',
     ];
+    const ignoreDefaultArgs = options.ignoreDefaultChromeArgs ?? false;
     if (headless) {
         args.push('--screen-info={3840x2160}');
     }
@@ -142,6 +143,7 @@ export async function launch(options) {
             pipe: true,
             headless,
             args,
+            ignoreDefaultArgs: ignoreDefaultArgs,
             acceptInsecureCerts: options.acceptInsecureCerts,
             handleDevToolsAsPage: true,
         });
@@ -153,7 +155,6 @@ export async function launch(options) {
         }
         if (options.viewport) {
             const [page] = await browser.pages();
-            // @ts-expect-error internal API for now.
             await page?.resize({
                 contentWidth: options.viewport.width,
                 contentHeight: options.viewport.height,