chrome-devtools-mcp 0.22.0 → 0.23.0

package/build/src/tools/inPage.js

@@ -3,7 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { zod, ajv, } from '../third_party/index.js';
+import { zod, ajv } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool } from './ToolDefinition.js';
 export const listInPageTools = definePageTool({
@@ -58,19 +58,6 @@ export const executeInPageTool = definePageTool({
                 throw new Error(`Failed to parse params as JSON: ${errorMessage}`);
             }
         }
-        // Creates array of ElementHandles from the UIDs in the params.
-        // We do not replace the uids with the ElementsHandles yet, because
-        // the `evaluate` function only turns them into DOM elements if they
-        // are passed as non-nested arguments.
-        const handles = [];
-        for (const value of Object.values(params)) {
-            if (value instanceof Object &&
-                'uid' in value &&
-                typeof value.uid === 'string' &&
-                Object.keys(value).length === 1) {
-                handles.push(await request.page.getElementByUid(value.uid));
-            }
-        }
         const toolGroup = request.page.getInPageTools();
         const tool = toolGroup?.tools.find(t => t.name === toolName);
         if (!tool) {
@@ -82,24 +69,6 @@ export const executeInPageTool = definePageTool({
         if (!valid) {
             throw new Error(`Invalid parameters for tool ${toolName}: ${ajvInstance.errorsText(validate.errors)}`);
         }
-        const result = await request.page.pptrPage.evaluate(async (name, args, ...elements) => {
-            // Replace the UIDs with DOM elements.
-            for (const [key, value] of Object.entries(args)) {
-                if (value instanceof Object &&
-                    'uid' in value &&
-                    typeof value.uid === 'string' &&
-                    Object.keys(value).length === 1) {
-                    args[key] = elements.shift();
-                }
-            }
-            if (!window.__dtmcp?.executeTool) {
-                throw new Error('No tools found on the page');
-            }
-            const toolResult = await window.__dtmcp.executeTool(name, args);
-            return {
-                result: toolResult,
-            };
-        }, toolName, params, ...handles);
-        response.appendResponseLine(JSON.stringify(result, null, 2));
+        await request.page.executeInPageTool(toolName, params, response);
     },
 });

package/build/src/tools/network.js

@@ -58,7 +58,7 @@ export const listNetworkRequests = definePageTool({
             .describe('Set to true to return the preserved requests over the last 3 navigations.'),
     },
     handler: async (request, response, context) => {
-        const data = await context.getDevToolsData(request.page);
+        const data = await request.page.getDevToolsData();
         response.attachDevToolsData(data);
         const reqid = data?.cdpRequestId
             ? context.resolveCdpRequestId(request.page, data.cdpRequestId)
@@ -101,7 +101,7 @@ export const getNetworkRequest = definePageTool({
             });
         }
         else {
-            const data = await context.getDevToolsData(request.page);
+            const data = await request.page.getDevToolsData();
             response.attachDevToolsData(data);
             const reqid = data?.cdpRequestId
                 ? context.resolveCdpRequestId(request.page, data.cdpRequestId)

package/build/src/tools/pages.js

@@ -7,6 +7,51 @@ import { logger } from '../logger.js';
 import { zod } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { CLOSE_PAGE_ERROR, definePageTool, defineTool, timeoutSchema, } from './ToolDefinition.js';
+async function navigateWithInterception(page, action, allowListString, timeout) {
+    const allowList = allowListString
+        ? allowListString.split(',').map((p) => new URLPattern(p.trim()))
+        : undefined;
+    const requestHandler = (interceptedRequest) => {
+        if (!interceptedRequest.isNavigationRequest()) {
+            void interceptedRequest.continue();
+            return;
+        }
+        const requestUrl = interceptedRequest.url();
+        const isAllowed = allowList.some((pattern) => pattern.test(requestUrl));
+        if (isAllowed) {
+            void interceptedRequest.continue();
+        }
+        else {
+            logger(`Blocking request to: ${requestUrl}`);
+            void interceptedRequest.abort('blockedbyclient');
+        }
+    };
+    const cleanupInterception = async () => {
+        if (allowList) {
+            page.pptrPage.off('request', requestHandler);
+            await page.pptrPage.setRequestInterception(false).catch(error => {
+                logger(`Failed to disable request interception`, error);
+            });
+        }
+    };
+    if (allowList) {
+        await page.pptrPage.setRequestInterception(true);
+        page.pptrPage.on('request', requestHandler);
+    }
+    try {
+        await page.waitForEventsAfterAction(async () => {
+            try {
+                await action();
+            }
+            finally {
+                await cleanupInterception();
+            }
+        }, { timeout });
+    }
+    finally {
+        await cleanupInterception();
+    }
+}
 export const listPages = defineTool(args => {
     return {
         name: 'list_pages',
@@ -78,159 +123,177 @@ export const closePage = defineTool({
         response.setListInPageTools();
     },
 });
-export const newPage = defineTool({
-    name: 'new_page',
-    description: `Open a new tab and load a URL. Use project URL if not specified otherwise.`,
-    annotations: {
-        category: ToolCategory.NAVIGATION,
-        readOnlyHint: false,
-    },
-    schema: {
-        url: zod.string().describe('URL to load in a new page.'),
-        background: zod
-            .boolean()
-            .optional()
-            .describe('Whether to open the page in the background without bringing it to the front. Default is false (foreground).'),
-        isolatedContext: zod
-            .string()
-            .optional()
-            .describe('If specified, the page is created in an isolated browser context with the given name. ' +
-            'Pages in the same browser context share cookies and storage. ' +
-            'Pages in different browser contexts are fully isolated.'),
-        ...timeoutSchema,
-    },
-    handler: async (request, response, context) => {
-        const page = await context.newPage(request.params.background, request.params.isolatedContext);
-        await page.waitForEventsAfterAction(async () => {
-            await page.pptrPage.goto(request.params.url, {
+export const newPage = defineTool(args => {
+    return {
+        name: 'new_page',
+        description: `Open a new tab and load a URL. Use project URL if not specified otherwise.`,
+        annotations: {
+            category: ToolCategory.NAVIGATION,
+            readOnlyHint: false,
+        },
+        schema: {
+            url: zod.string().describe('URL to load in a new page.'),
+            background: zod
+                .boolean()
+                .optional()
+                .describe('Whether to open the page in the background without bringing it to the front. Default is false (foreground).'),
+            isolatedContext: zod
+                .string()
+                .optional()
+                .describe('If specified, the page is created in an isolated browser context with the given name. ' +
+                'Pages in the same browser context share cookies and storage. ' +
+                'Pages in different browser contexts are fully isolated.'),
+            ...(args?.experimentalNavigationAllowlist
+                ? {
+                    allowList: zod
+                        .string()
+                        .optional()
+                        .describe('Optional comma-separated list of URL patterns to allow. If provided, all other navigations will be blocked.'),
+                }
+                : {}),
+            ...timeoutSchema,
+        },
+        handler: async (request, response, context) => {
+            const page = await context.newPage(request.params.background, request.params.isolatedContext);
+            await navigateWithInterception(page, () => page.pptrPage.goto(request.params.url, {
                 timeout: request.params.timeout,
-            });
-        }, { timeout: request.params.timeout });
-        response.setIncludePages(true);
-        response.setListInPageTools();
-    },
+            }), request.params.allowList, request.params.timeout);
+            response.setIncludePages(true);
+            response.setListInPageTools();
+        },
+    };
 });
-export const navigatePage = definePageTool({
-    name: 'navigate_page',
-    description: `Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.`,
-    annotations: {
-        category: ToolCategory.NAVIGATION,
-        readOnlyHint: false,
-    },
-    schema: {
-        type: zod
-            .enum(['url', 'back', 'forward', 'reload'])
-            .optional()
-            .describe('Navigate the page by URL, back or forward in history, or reload.'),
-        url: zod.string().optional().describe('Target URL (only type=url)'),
-        ignoreCache: zod
-            .boolean()
-            .optional()
-            .describe('Whether to ignore cache on reload.'),
-        handleBeforeUnload: zod
-            .enum(['accept', 'decline'])
-            .optional()
-            .describe('Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept.'),
-        initScript: zod
-            .string()
-            .optional()
-            .describe('A JavaScript script to be executed on each new document before any other scripts for the next navigation.'),
-        ...timeoutSchema,
-    },
-    handler: async (request, response) => {
-        const page = request.page;
-        const options = {
-            timeout: request.params.timeout,
-        };
-        if (!request.params.type && !request.params.url) {
-            throw new Error('Either URL or a type is required.');
-        }
-        if (!request.params.type) {
-            request.params.type = 'url';
-        }
-        const handleBeforeUnload = request.params.handleBeforeUnload ?? 'accept';
-        const dialogHandler = (dialog) => {
-            if (dialog.type() === 'beforeunload') {
-                if (handleBeforeUnload === 'accept') {
-                    response.appendResponseLine(`Accepted a beforeunload dialog.`);
-                    void dialog.accept();
+export const navigatePage = definePageTool(args => {
+    return {
+        name: 'navigate_page',
+        description: `Go to a URL, or back, forward, or reload. Use project URL if not specified otherwise.`,
+        annotations: {
+            category: ToolCategory.NAVIGATION,
+            readOnlyHint: false,
+        },
+        schema: {
+            type: zod
+                .enum(['url', 'back', 'forward', 'reload'])
+                .optional()
+                .describe('Navigate the page by URL, back or forward in history, or reload.'),
+            url: zod.string().optional().describe('Target URL (only type=url)'),
+            ignoreCache: zod
+                .boolean()
+                .optional()
+                .describe('Whether to ignore cache on reload.'),
+            handleBeforeUnload: zod
+                .enum(['accept', 'decline'])
+                .optional()
+                .describe('Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept.'),
+            initScript: zod
+                .string()
+                .optional()
+                .describe('A JavaScript script to be executed on each new document before any other scripts for the next navigation.'),
+            ...(args?.experimentalNavigationAllowlist
+                ? {
+                    allowList: zod
+                        .string()
+                        .optional()
+                        .describe('Optional comma-separated list of URL patterns to allow. If provided, all other navigations will be blocked.'),
                 }
-                else {
-                    response.appendResponseLine(`Declined a beforeunload dialog.`);
-                    void dialog.dismiss();
+                : {}),
+            ...timeoutSchema,
+        },
+        handler: async (request, response) => {
+            const page = request.page;
+            const options = {
+                timeout: request.params.timeout,
+            };
+            if (!request.params.type && !request.params.url) {
+                throw new Error('Either URL or a type is required.');
+            }
+            if (!request.params.type) {
+                request.params.type = 'url';
+            }
+            const handleBeforeUnload = request.params.handleBeforeUnload ?? 'accept';
+            const dialogHandler = (dialog) => {
+                if (dialog.type() === 'beforeunload') {
+                    if (handleBeforeUnload === 'accept') {
+                        response.appendResponseLine(`Accepted a beforeunload dialog.`);
+                        void dialog.accept();
+                    }
+                    else {
+                        response.appendResponseLine(`Declined a beforeunload dialog.`);
+                        void dialog.dismiss();
+                    }
+                    // We are not going to report the dialog like regular dialogs.
+                    page.clearDialog();
                 }
-                // We are not going to report the dialog like regular dialogs.
-                page.clearDialog();
+            };
+            let initScriptId;
+            if (request.params.initScript) {
+                const { identifier } = await page.pptrPage.evaluateOnNewDocument(request.params.initScript);
+                initScriptId = identifier;
             }
-        };
-        let initScriptId;
-        if (request.params.initScript) {
-            const { identifier } = await page.pptrPage.evaluateOnNewDocument(request.params.initScript);
-            initScriptId = identifier;
-        }
-        page.pptrPage.on('dialog', dialogHandler);
-        try {
-            await page.waitForEventsAfterAction(async () => {
-                switch (request.params.type) {
-                    case 'url':
-                        if (!request.params.url) {
-                            throw new Error('A URL is required for navigation of type=url.');
-                        }
-                        try {
-                            await page.pptrPage.goto(request.params.url, options);
-                            response.appendResponseLine(`Successfully navigated to ${request.params.url}.`);
-                        }
-                        catch (error) {
-                            response.appendResponseLine(`Unable to navigate in the selected page: ${error.message}.`);
-                        }
-                        break;
-                    case 'back':
-                        try {
-                            await page.pptrPage.goBack(options);
-                            response.appendResponseLine(`Successfully navigated back to ${page.pptrPage.url()}.`);
-                        }
-                        catch (error) {
-                            response.appendResponseLine(`Unable to navigate back in the selected page: ${error.message}.`);
-                        }
-                        break;
-                    case 'forward':
-                        try {
-                            await page.pptrPage.goForward(options);
-                            response.appendResponseLine(`Successfully navigated forward to ${page.pptrPage.url()}.`);
-                        }
-                        catch (error) {
-                            response.appendResponseLine(`Unable to navigate forward in the selected page: ${error.message}.`);
-                        }
-                        break;
-                    case 'reload':
-                        try {
-                            await page.pptrPage.reload({
-                                ...options,
-                                ignoreCache: request.params.ignoreCache,
-                            });
-                            response.appendResponseLine(`Successfully reloaded the page.`);
-                        }
-                        catch (error) {
-                            response.appendResponseLine(`Unable to reload the selected page: ${error.message}.`);
-                        }
-                        break;
+            page.pptrPage.on('dialog', dialogHandler);
+            try {
+                await navigateWithInterception(page, async () => {
+                    switch (request.params.type) {
+                        case 'url':
+                            if (!request.params.url) {
+                                throw new Error('A URL is required for navigation of type=url.');
+                            }
+                            try {
+                                await page.pptrPage.goto(request.params.url, options);
+                                response.appendResponseLine(`Successfully navigated to ${request.params.url}.`);
+                            }
+                            catch (error) {
+                                response.appendResponseLine(`Unable to navigate in the selected page: ${error.message}.`);
+                            }
+                            break;
+                        case 'back':
+                            try {
+                                await page.pptrPage.goBack(options);
+                                response.appendResponseLine(`Successfully navigated back to ${page.pptrPage.url()}.`);
+                            }
+                            catch (error) {
+                                response.appendResponseLine(`Unable to navigate back in the selected page: ${error.message}.`);
+                            }
+                            break;
+                        case 'forward':
+                            try {
+                                await page.pptrPage.goForward(options);
+                                response.appendResponseLine(`Successfully navigated forward to ${page.pptrPage.url()}.`);
+                            }
+                            catch (error) {
+                                response.appendResponseLine(`Unable to navigate forward in the selected page: ${error.message}.`);
+                            }
+                            break;
+                        case 'reload':
+                            try {
+                                await page.pptrPage.reload({
+                                    ...options,
+                                    ignoreCache: request.params.ignoreCache,
+                                });
+                                response.appendResponseLine(`Successfully reloaded the page.`);
+                            }
+                            catch (error) {
+                                response.appendResponseLine(`Unable to reload the selected page: ${error.message}.`);
+                            }
+                            break;
+                    }
+                }, request.params.allowList, request.params.timeout);
+            }
+            finally {
+                page.pptrPage.off('dialog', dialogHandler);
+                if (initScriptId) {
+                    await page.pptrPage
+                        .removeScriptToEvaluateOnNewDocument(initScriptId)
+                        .catch(error => {
+                        logger(`Failed to remove init script`, error);
+                    });
                 }
-            }, { timeout: request.params.timeout });
-        }
-        finally {
-            page.pptrPage.off('dialog', dialogHandler);
-            if (initScriptId) {
-                await page.pptrPage
-                    .removeScriptToEvaluateOnNewDocument(initScriptId)
-                    .catch(error => {
-                    logger(`Failed to remove init script`, error);
-                });
             }
-        }
-        response.setIncludePages(true);
-        response.setListInPageTools();
-        response.setListWebMcpTools();
-    },
+            response.setIncludePages(true);
+            response.setListInPageTools();
+            response.setListWebMcpTools();
+        },
+    };
 });
 export const resizePage = definePageTool({
     name: 'resize_page',

package/build/src/tools/screencast.js

@@ -14,33 +14,44 @@ async function generateTempFilePath() {
     const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'chrome-devtools-mcp-'));
     return path.join(dir, `screencast.mp4`);
 }
-export const startScreencast = definePageTool({
+const supportedExtensions = ['.webm', '.mp4'];
+export const startScreencast = definePageTool(args => ({
     name: 'screencast_start',
-    description: 'Starts recording a screencast (video) of the selected page in mp4 format.',
+    description: `Starts recording a screencast (video) of the selected page in specified format.`,
     annotations: {
         category: ToolCategory.DEBUGGING,
         readOnlyHint: false,
         conditions: ['screencast'],
     },
     schema: {
-        path: zod
+        filePath: zod
             .string()
             .optional()
-            .describe('Output path. Uses mkdtemp to generate a unique path if not provided.'),
+            .describe(`Output file path (${supportedExtensions.join(',')} are supported). Uses mkdtemp to generate a unique path if not provided.`),
     },
     handler: async (request, response, context) => {
         if (context.getScreenRecorder() !== null) {
             response.appendResponseLine('Error: a screencast recording is already in progress. Use screencast_stop to stop it before starting a new one.');
             return;
         }
-        const filePath = request.params.path ?? (await generateTempFilePath());
-        const resolvedPath = ensureExtension(path.resolve(filePath), '.mp4');
+        const filePath = request.params.filePath ?? (await generateTempFilePath());
+        let enforcedExtension = '.mp4';
+        let format = 'mp4';
+        for (const supportedExtension of supportedExtensions) {
+            if (filePath.endsWith(supportedExtension)) {
+                enforcedExtension = supportedExtension;
+                format = supportedExtension.substring(1);
+                break;
+            }
+        }
+        const resolvedPath = ensureExtension(path.resolve(filePath), enforcedExtension);
         const page = request.page;
         let recorder;
         try {
             recorder = await page.pptrPage.screencast({
                 path: resolvedPath,
-                format: 'mp4',
+                format: format,
+                ffmpegPath: args?.experimentalFfmpegPath,
             });
         }
         catch (err) {
@@ -54,7 +65,7 @@ export const startScreencast = definePageTool({
         context.setScreenRecorder({ recorder, filePath: resolvedPath });
         response.appendResponseLine(`Screencast recording started. The recording will be saved to ${resolvedPath}. Use ${stopScreencast.name} to stop recording.`);
     },
-});
+}));
 export const stopScreencast = definePageTool({
     name: 'screencast_stop',
     description: 'Stops the active screencast recording on the selected page.',

package/build/src/version.js

@@ -5,5 +5,5 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.22.0';
+export const VERSION = '0.23.0';
 // x-release-please-end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -80,6 +80,7 @@
     "tiktoken": "^1.0.22",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.43.0",
+    "urlpattern-polyfill": "^10.1.0",
     "yargs": "18.0.0"
   },
   "engines": {