⚡ Havoc

Unleash Chaos on Your Endpoints.

---

Installation

npm install -g havoc

---

🛠️ Usage

Run a simple load test:

havoc run --url https://api.example.com --users 100 --time 1m

Example Output

🌪 Havoc Load Test: https://api.example.com
Users: 100   Duration: 1m   Spawn Rate: 10/s
-------------------------------------------------------
Requests/sec:   12,340
Latency (p50):  115 ms
Latency (p90):  230 ms
Latency (p99):  410 ms
Error Rate:     0.3 %
Total Requests: 740,100
-------------------------------------------------------
✅ Test completed in 60s

Export results as JSON or CSV for CI/CD pipelines:

havoc run --url https://api.example.com --report json > results.json
havoc run --url https://api.example.com --report csv > results.csv

---

Development

Clone the repo and set up:

npm install
npm run build   # compile TypeScript to /dist
npm run test    # run unit tests

Link locally for testing:

npm link
havoc run --url https://api.example.com --users 10 --time 10s

License

MIT © 2025 Havoc