{
  "slug": "chrome-devtools-mcp-query-heapsnapshot-objects-c8cdc2930ea3",
  "title": "chrome-devtools-mcp query_heapsnapshot_objects",
  "tools": [
    "chrome-devtools-mcp"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-25T11:35:48.000Z",
  "announced_at": "2026-08-25T11:35:48.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When investigating memory use or detached DOM nodes, start chrome-devtools-mcp with memory debugging enabled, then call `query_heapsnapshot_objects` on a `.heapsnapshot` file with the needed filters and pagination.",
    "examples": [
      "query_heapsnapshot_objects({\"filePath\":\"<path>.heapsnapshot\",\"className\":\"<class name or regex>\",\"isDetached\":true,\"pageIdx\":0,\"pageSize\":20})",
      "query_heapsnapshot_objects({\"filePath\":\"<path>.heapsnapshot\",\"propertyName\":\"<property>\",\"nodeType\":\"<V8 node type>\",\"minRetainedSize\":<bytes>,\"maxRetainedSize\":<bytes>,\"minSelfSize\":<bytes>,\"maxSelfSize\":<bytes>,\"sortBy\":\"retainedSize\",\"pageIdx\":0,\"pageSize\":20})",
      "npx chrome-devtools-mcp@1.8.0 --memoryDebugging=true"
    ],
    "gotchas": [
      "Version: 1.8.0",
      "filePath (required): Path to a `.heapsnapshot` file to read.",
      "className: Regex or text matching the object class name.",
      "propertyName: Filter on outgoing reference edge property name.",
      "nodeType: V8 node type filter, e.g. object, closure, string, array, code.",
      "isDetached: Filter for detached DOM nodes.",
      "minRetainedSize: Minimum retained size in bytes.",
      "maxRetainedSize: Maximum retained size in bytes.",
      "minSelfSize: Minimum self size in bytes.",
      "maxSelfSize: Maximum self size in bytes.",
      "pageIdx: Page index for pagination.",
      "pageSize: Page size for pagination.",
      "sortBy: Sort by `retainedSize`, `selfSize`, or `id`; defaults to `retainedSize`.",
      "Prerequisite: Start the server with `--memoryDebugging=true` to enable this tool.",
      "Prerequisite: Supply a `.heapsnapshot` file path.",
      "`filePath` must point to a `.heapsnapshot` file.",
      "`sortBy` accepts `retainedSize`, `selfSize`, or `id`; it defaults to `retainedSize`.",
      "Size filters are measured in bytes."
    ]
  },
  "why_it_matters": "Filter and sort objects in a heap snapshot while investigating memory use or detached DOM nodes.",
  "sources": [
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/releases/tag/chrome-devtools-mcp-v1.8.0",
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/2553",
    "https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/fadbf41d96db84cea12e379592bc13b005c053b4/docs/tool-reference.md"
  ],
  "rank": 0.93031,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "ghtools-20261008",
    "verdict_id": "ghtools-20261008:ghtools-20261008-03b1ce95dd8dcded-3:gate",
    "evidence_hash": "d1c02b64abd3eac67612ba31a1ccd5e85e0544264fefbebac90e612d2e8a3a01"
  },
  "review": {
    "draft_hash": "3125505c7c44ed72605c5b687bc84a4c9ef11fadeabd0212151195c4ae251689",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "ghtools-20261008:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.93 >= 0.9; 2 needed) and Jev gave 0.80 (>= 0.6 needed)."
  }
}