chrome-devtools-mcp 0.26.0 → 1.0.1

package/build/src/third_party/issue-descriptions/genericBackUINavigationWouldSkipAd.md

@@ -0,0 +1,4 @@
+# Back UI Navigation Will Skip Ad
+
+An ad-related entry was found in the session history. If the user navigates back
+via the browser UI, this ad entry will be skipped.

package/build/src/tools/ToolDefinition.js

@@ -64,7 +64,7 @@ export function geolocationTransform(arg) {
     if (!arg) {
         return undefined;
     }
-    const [latitude, longitude] = arg.split('x').map(Number);
+    const [latitude, longitude] = arg.split(',').map(Number);
     return {
         latitude,
         longitude,

package/build/src/tools/emulation.js

@@ -33,7 +33,7 @@ export const emulate = definePageTool({
             .string()
             .optional()
             .transform(geolocationTransform)
-            .describe('Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
+            .describe('Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
         userAgent: zod
             .string()
             .optional()
@@ -49,9 +49,10 @@ export const emulate = definePageTool({
             .describe(`Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.`),
     },
     blockedByDialog: true,
-    handler: async (request, _response, context) => {
+    handler: async (request, response, context) => {
         const page = request.page;
         await context.emulate(request.params, page.pptrPage);
+        response.appendResponseLine('Emulation configured successfully');
     },
 });
 //# sourceMappingURL=emulation.js.map

package/build/src/tools/input.js

@@ -85,7 +85,7 @@ export const click = definePageTool({
         const aXNode = request.page.getAXNodeByUid(uid);
         const shouldSelectNativeOption = !request.params.dblClick && aXNode?.role === 'option';
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 if (shouldSelectNativeOption &&
                     (await selectNativeSelectOption(handle))) {
                     return;
@@ -97,6 +97,7 @@ export const click = definePageTool({
             response.appendResponseLine(request.params.dblClick
                 ? `Successfully double clicked on the element`
                 : `Successfully clicked on the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -126,14 +127,15 @@ export const clickAt = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.mouse.click(request.params.x, request.params.y, {
-                clickCount: request.params.dblClick ? 2 : 1,
+                count: request.params.dblClick ? 2 : 1,
             });
         });
         response.appendResponseLine(request.params.dblClick
             ? `Successfully double clicked at the coordinates`
             : `Successfully clicked at the coordinates`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -157,10 +159,11 @@ export const hover = definePageTool({
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await handle.asLocator().hover();
             });
             response.appendResponseLine(`Successfully hovered over the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -269,10 +272,11 @@ export const fill = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await fillFormElement(request.params.uid, request.params.value, context, page);
         });
         response.appendResponseLine(`Successfully filled out the element`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -292,13 +296,14 @@ export const typeText = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.keyboard.type(request.params.text);
             if (request.params.submitKey) {
                 await page.pptrPage.keyboard.press(request.params.submitKey);
             }
         });
         response.appendResponseLine(`Typed text "${request.params.text}${request.params.submitKey ? ` + ${request.params.submitKey}` : ''}"`);
+        response.attachWaitForResult(result);
     },
 });
 export const drag = definePageTool({
@@ -318,12 +323,13 @@ export const drag = definePageTool({
         const fromHandle = await request.page.getElementByUid(request.params.from_uid);
         const toHandle = await request.page.getElementByUid(request.params.to_uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await fromHandle.drag(toHandle);
                 await new Promise(resolve => setTimeout(resolve, 50));
                 await toHandle.drop(fromHandle);
             });
             response.appendResponseLine(`Successfully dragged an element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -357,12 +363,14 @@ export const fillForm = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
+        let lastResult = {};
         for (const element of request.params.elements) {
-            await page.waitForEventsAfterAction(async () => {
+            lastResult = await page.waitForEventsAfterAction(async () => {
                 await fillFormElement(element.uid, element.value, context, page);
             });
         }
         response.appendResponseLine(`Successfully filled out the form`);
+        response.attachWaitForResult(lastResult);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -434,7 +442,7 @@ export const pressKey = definePageTool({
         const page = request.page;
         const tokens = parseKey(request.params.key);
         const [key, ...modifiers] = tokens;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             for (const modifier of modifiers) {
                 await page.pptrPage.keyboard.down(modifier);
             }
@@ -444,6 +452,7 @@ export const pressKey = definePageTool({
             }
         });
         response.appendResponseLine(`Successfully pressed key: ${request.params.key}`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }

package/build/src/tools/memory.js

@@ -103,4 +103,28 @@ export const getNodesByClass = defineTool({
         });
     },
 });
+export const getNodeRetainers = defineTool({
+    name: 'get_node_retainers',
+    description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['experimentalMemory'],
+    },
+    blockedByDialog: false,
+    schema: {
+        filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
+        nodeId: zod.number().describe('The stable node ID to get retainers for.'),
+        pageIdx: zod.number().optional().describe('The page index for pagination.'),
+        pageSize: zod.number().optional().describe('The page size for pagination.'),
+    },
+    handler: async (request, response, context) => {
+        context.validatePath(request.params.filePath);
+        const retainers = await context.getHeapSnapshotRetainers(request.params.filePath, request.params.nodeId);
+        response.setHeapSnapshotNodes(retainers, {
+            pageIdx: request.params.pageIdx,
+            pageSize: request.params.pageSize,
+        });
+    },
+});
 //# sourceMappingURL=memory.js.map

package/build/src/tools/script.js

@@ -32,6 +32,10 @@ Example with arguments: \`(el) => {
                 .describe('The uid of an element on the page from the page content snapshot'))
                 .optional()
                 .describe(`An optional list of arguments to pass to the function.`),
+            filePath: zod
+                .string()
+                .optional()
+                .describe('The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.'),
             dialogAction: zod
                 .string()
                 .optional()
@@ -48,7 +52,8 @@ Example with arguments: \`(el) => {
         },
         blockedByDialog: true,
         handler: async (request, response, context) => {
-            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, } = request.params;
+            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, filePath, } = request.params;
+            context.validatePath(filePath);
             if (cliArgs?.categoryExtensions && serviceWorkerId) {
                 if (uidArgs && uidArgs.length > 0) {
                     throw new Error('args (element uids) cannot be used when evaluating in a service worker.');
@@ -57,9 +62,15 @@ Example with arguments: \`(el) => {
                     throw new Error('specify either a pageId or a serviceWorkerId.');
                 }
                 const worker = await getWebWorker(context, serviceWorkerId);
-                await context.getSelectedMcpPage().waitForEventsAfterAction(async () => {
-                    await performEvaluation(worker, fnString, [], response);
+                const result = await context
+                    .getSelectedMcpPage()
+                    .waitForEventsAfterAction(async () => {
+                    await performEvaluation(worker, fnString, [], response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
                 return;
             }
             const mcpPage = cliArgs?.experimentalPageIdRouting
@@ -75,9 +86,13 @@ Example with arguments: \`(el) => {
                     args.push(handle);
                 }
                 const evaluatable = await getPageOrFrame(page, frames);
-                await mcpPage.waitForEventsAfterAction(async () => {
-                    await performEvaluation(evaluatable, fnString, args, response);
+                const result = await mcpPage.waitForEventsAfterAction(async () => {
+                    await performEvaluation(evaluatable, fnString, args, response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
             }
             finally {
                 void Promise.allSettled(args.map(arg => arg.dispose()));
@@ -85,17 +100,24 @@ Example with arguments: \`(el) => {
         },
     };
 });
-const performEvaluation = async (evaluatable, fnString, args, response) => {
+const performEvaluation = async (evaluatable, fnString, args, response, options) => {
     const fn = await evaluatable.evaluateHandle(`(${fnString})`);
     try {
         const result = await evaluatable.evaluate(async (fn, ...args) => {
             // @ts-expect-error no types for function fn
             return JSON.stringify(await fn(...args));
         }, fn, ...args);
-        response.appendResponseLine('Script ran on page and returned:');
-        response.appendResponseLine('```json');
-        response.appendResponseLine(`${result}`);
-        response.appendResponseLine('```');
+        if (options?.filePath) {
+            const data = new TextEncoder().encode(result ?? 'undefined');
+            const { filename } = await options.context.saveFile(data, options.filePath, '.json');
+            response.appendResponseLine(`Script ran on page. Output saved to ${filename}.`);
+        }
+        else {
+            response.appendResponseLine('Script ran on page and returned:');
+            response.appendResponseLine('```json');
+            response.appendResponseLine(`${result}`);
+            response.appendResponseLine('```');
+        }
     }
     finally {
         void fn.dispose();

package/build/src/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.26.0';
+export const VERSION = '1.0.1';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.26.0",
+  "version": "1.0.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -62,7 +62,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1626840",
+    "chrome-devtools-frontend": "1.0.1631386",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -71,8 +71,8 @@
     "globals": "^17.0.0",
     "lighthouse": "13.3.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.43.0",
-    "rollup": "4.60.3",
+    "puppeteer": "25.0.4",
+    "rollup": "4.60.4",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",
@@ -84,5 +84,8 @@
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "overrides": {
+    "puppeteer-core": "$puppeteer"
   }
 }

package/build/src/telemetry/metricUtils.js

@@ -1,15 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-const LATENCY_BUCKETS = [50, 100, 250, 500, 1000, 2500, 5000, 10000];
-export function bucketizeLatency(latencyMs) {
-    for (const bucket of LATENCY_BUCKETS) {
-        if (latencyMs <= bucket) {
-            return bucket;
-        }
-    }
-    return LATENCY_BUCKETS[LATENCY_BUCKETS.length - 1];
-}
-//# sourceMappingURL=metricUtils.js.map