next-memory-profiler

A CLI tool to measure memory leaks and JS heap usage in Next.js projects

🔹 Features

• Measures JS heap usage during navigation
• Tracks heap trends and warns on increases
• Fast CLI usage
• Easily extendable for JSON/HTML report generation

🔹 Installation

1. Clone the repository

git clone https://github.com/username/next-memory-profiler.git
cd next-memory-profiler

2. Install dependencies

npm install

3. Install Playwright browsers

npx playwright install

4. Build the project

npm run build

5. Link as a global CLI (optional)

npm link

🔹 Usage

Run with Node

node ./dist/index.js --url=http://localhost:3000 --pages=/,/about,/dashboard

Run via npm script

npm run start -- --url=http://localhost:3000 --pages=/,/about,/dashboard

Run as global CLI (after npm link)

next-memory-profiler --url=http://localhost:3000 --pages=/,/about,/dashboard

🔹 Example Output

[INFO] / → Heap: 7.69 MB
[INFO] /audience-tracker → Heap: 11.27 MB
[WARNING] Heap increased +46.5% → Possible memory leak!

[SUMMARY] Heap trend: 7.69 MB → 11.27 MB

• [INFO] → Page loaded, heap usage
• [WARNING] → Heap increased more than 20% compared to previous page, possible memory leak
• [SUMMARY] → Heap trend after navigation

🔹 CLI Parameters

| Parameter | Description | Example | | --------- | ------------------------------------------- | ----------------------------- | | --url | Base URL of the Next.js application to test | --url=http://localhost:3000 | | --pages | Comma-separated list of pages to measure | --pages=/,/about,/dashboard |

🔹 Development

• Built with TypeScript
• runner.ts → Navigates pages and measures heap
• analyzer.ts → Checks for heap growth
• index.ts → CLI entry point

Build

npm run build

Test

npm run start -- --url=http://localhost:3000 --pages=/,/about

🔹 Future Features

• JSON / HTML report generation
• CI/CD integration (e.g., GitHub Actions)
• Configurable thresholds and warning levels

🔹 License

MIT License © 2025 Berna Şimşek