Files
bun.sh/docs/guides/runtime/heap-snapshot.mdx
2025-11-05 11:14:21 -08:00

29 lines
860 B
Plaintext

---
title: Inspect memory usage using V8 heap snapshots
sidebarTitle: Heap snapshots
mode: center
---
Bun implements V8's heap snapshot API, which allows you to create snapshots of the heap at runtime. This helps debug memory leaks in your JavaScript/TypeScript application.
```ts snapshot.ts icon="/icons/typescript.svg"
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
<Frame>![Chrome DevTools Memory Tab](/images/chrome-devtools-memory.png)</Frame>