Skip to main content

Inspect memory usage using V8 heap snapshots

Bun implements V8's heap snapshot API. Use it to capture the heap at runtime and debug memory leaks in your JavaScript/TypeScript application.

import v8 from "node:v8";

// Creates a heap snapshot file with an auto-generated name
const snapshotPath = v8.writeHeapSnapshot();
console.log(`Heap snapshot written to: ${snapshotPath}`);

Inspect memory in Chrome DevTools

To view V8 heap snapshots in Chrome DevTools:

  1. Open Chrome DevTools (F12 or right-click and select "Inspect")
  2. Go to the "Memory" tab
  3. Click the "Load" button (folder icon)
  4. Select your .heapsnapshot file

Chrome DevTools Memory Tab

Translation © 2026 fanyi.dev · Original © 2026 the Bun project (LICENSE.md names no copyright holder) (MIT)