AphrodyBun GitHub

Runtime docs · Guides · Runtime & Debugging

Inspect memory usage using V8 heap snapshots

Write a V8 heap snapshot with node:v8 and load it in Chrome DevTools to debug memory leaks.

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

snapshot.ts
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