Chrome DevTools for coding agents
feat: add take_memory_snapshot tool (#1023)
Alex Rudenko7ffdc5ee4d9d
diff --git a/README.md b/README.mdindex b94217b2..1853ed75 100644--- a/README.md+++ b/README.md@@ -433,10 +433,11 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles- **Emulation** (2 tools)- [`emulate`](docs/tool-reference.md#emulate)- [`resize_page`](docs/tool-reference.md#resize_page)-- **Performance** (3 tools)+- **Performance** (4 tools)- [`performance_analyze_insight`](docs/tool-reference.md#performance_analyze_insight)- [`performance_start_trace`](docs/tool-reference.md#performance_start_trace)- [`performance_stop_trace`](docs/tool-reference.md#performance_stop_trace)+ - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)- **Network** (2 tools)- [`get_network_request`](docs/tool-reference.md#get_network_request)- [`list_network_requests`](docs/tool-reference.md#list_network_requests)diff --git a/docs/tool-reference.md b/docs/tool-reference.mdindex 52c1e9c6..776859ac 100644--- a/docs/tool-reference.md+++ b/docs/tool-reference.md@@ -1,6 +1,6 @@<!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->-# Chrome DevTools MCP Tool Reference (~6719 cl100k_base tokens)+# Chrome DevTools MCP Tool Reference (~6885 cl100k_base tokens)- **[Input automation](#input-automation)** (8 tools)- [`click`](#click)@@ -21,10 +21,11 @@- **[Emulation](#emulation)** (2 tools)- [`emulate`](#emulate)- [`resize_page`](#resize_page)-- **[Performance](#performance)** (3 tools)+- **[Performance](#performance)** (4 tools)- [`performance_analyze_insight`](#performance_analyze_insight)- [`performance_start_trace`](#performance_start_trace)- [`performance_stop_trace`](#performance_stop_trace)+ - [`take_memory_snapshot`](#take_memory_snapshot)- **[Network](#network)** (2 tools)- [`get_network_request`](#get_network_request)- [`list_network_requests`](#list_network_requests)@@ -262,6 +263,16 @@---+### `take_memory_snapshot`++**Description:** Capture a memory heapsnapshot of the currently selected page to memory leak debugging++**Parameters:**++- **filePath** (string) **(required)**: A path to a .heapsnapshot file to save the heapsnapshot to.++---+## Network### `get_network_request`diff --git a/src/tools/memory.ts b/src/tools/memory.tsnew file mode 100644index 00000000..9c13be23--- /dev/null+++ b/src/tools/memory.ts@@ -0,0 +1,36 @@+/**+ * @license+ * Copyright 2025 Google LLC+ * SPDX-License-Identifier: Apache-2.0+ */++import {zod} from '../third_party/index.js';++import {ToolCategory} from './categories.js';+import {defineTool} from './ToolDefinition.js';++export const takeMemorySnapshot = defineTool({+ name: 'take_memory_snapshot',+ description: `Capture a memory heapsnapshot of the currently selected page to memory leak debugging`,+ annotations: {+ category: ToolCategory.PERFORMANCE,+ readOnlyHint: true,+ },+ schema: {+ filePath: zod+ .string()+ .describe('A path to a .heapsnapshot file to save the heapsnapshot to.')+ .endsWith('.heapsnapshot'),+ },+ handler: async (request, response, context) => {+ const page = context.getSelectedPage();++ await page.captureHeapSnapshot({+ path: request.params.filePath,+ });++ response.appendResponseLine(+ `Heap snapshot saved to ${request.params.filePath}`,+ );+ },+});diff --git a/src/tools/tools.ts b/src/tools/tools.tsindex 2aed860f..96bb033a 100644--- a/src/tools/tools.ts+++ b/src/tools/tools.ts@@ -8,6 +8,7 @@ import * as consoleTools from './console.js';import * as emulationTools from './emulation.js';import * as extensionTools from './extensions.js';import * as inputTools from './input.js';+import * as memoryTools from './memory.js';import * as networkTools from './network.js';import * as pagesTools from './pages.js';import * as performanceTools from './performance.js';@@ -22,6 +23,7 @@ const tools = [...Object.values(emulationTools),...Object.values(extensionTools),...Object.values(inputTools),+ ...Object.values(memoryTools),...Object.values(networkTools),...Object.values(pagesTools),...Object.values(performanceTools),diff --git a/tests/tools/memory.test.ts b/tests/tools/memory.test.tsnew file mode 100644index 00000000..16fc0876--- /dev/null+++ b/tests/tools/memory.test.ts@@ -0,0 +1,39 @@+/**+ * @license+ * Copyright 2026 Google LLC+ * SPDX-License-Identifier: Apache-2.0+ */++import assert from 'node:assert';+import {existsSync} from 'node:fs';+import {rm} from 'node:fs/promises';+import {tmpdir} from 'node:os';+import {join} from 'node:path';+import {describe, it} from 'node:test';++import {takeMemorySnapshot} from '../../src/tools/memory.js';+import {withMcpContext} from '../utils.js';++describe('memory', () => {+ describe('take_memory_snapshot', () => {+ it('with default options', async () => {+ await withMcpContext(async (response, context) => {+ const filePath = join(tmpdir(), 'test-screenshot.heapsnapshot');+ try {+ await takeMemorySnapshot.handler(+ {params: {filePath}},+ response,+ context,+ );+ assert.equal(+ response.responseLines.at(0),+ `Heap snapshot saved to ${filePath}`,+ );+ assert.ok(existsSync(filePath));+ } finally {+ await rm(filePath, {force: true});+ }+ });+ });+ });+});