Heap snapshot tools accept named filters
Introduced 2026-07-14 · score 0.93
HOW TO USE IT
When inspecting aggregates or class nodes retained through a named source, pass the matching optional `filterName` to the corresponding heap snapshot tool.
get_heapsnapshot_details({"filePath":"<path-to-heapsnapshot>","filterName":"objectsRetainedByDetachedDomNodes"})get_heapsnapshot_class_nodes({"filePath":"<path-to-heapsnapshot>","id":<class-id>,"filterName":"objectsRetainedByConsole"})WHY THIS HELPS
When inspecting heap snapshot nodes or aggregates retained through a specific source, apply the matching named filter.
REQUIREMENTS AND LIMITATIONS
- Version: 1.6.0
- filePath (required): Path to the .heapsnapshot file to read.
- id (required): Class ID obtained from details; required by get_heapsnapshot_class_nodes.
- filterName: Filter to apply to nodes or aggregates. Allowed: objectsRetainedByDetachedDomNodes, objectsRetainedByConsole, objectsRetainedByEventHandlers, objectsRetainedByContexts.
- Prerequisite: Enable heap snapshot tools with --memoryDebugging=true.
- filterName is optional and applies to nodes or aggregates.
FIRST-PARTY EVIDENCE
- https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.6.0
- https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/2323
- https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/2812902ba9dca67a320f00983e54d03b741388ce/docs/tool-reference.md
Check the installed version and the source before using it. Entry JSON