k6 Load Testing Tool Integration

[josecmu27]

k6 Load Testing Tool Integration

Summary

This PR integrates k6 as a dynamic analysis tool for load testing the NodeBB application. k6 simulates multiple concurrent users hitting key endpoints to measure performance and identify bottlenecks under stress.

---

Evidence of Installation

• Created k6/README.md with installation instructions (brew install k6)
• Created k6/load-test.js test script
• Created k6/output.txt containing terminal output from a full test run

---

Test Results

The test ramped up from 10 to 50 virtual users across ~3.5 minutes, hitting 4 key endpoints:

• / (Homepage)
• /categories
• /recent
• /api/categories

checks_total.......: 11952   45.684351/s
checks_succeeded...: 99.98%  11950 out of 11952
checks_failed......: 0.01%   2 out of 11952

✓ homepage status is 200
✗ homepage loads in <2s
  ↳  99% — ✓ 1327 / ✗ 1
✓ categories status is 200
✓ categories loads in <2s
✓ recent topics status is 200
✗ recent topics loads in <2s
  ↳  99% — ✓ 1327 / ✗ 1
✓ API status is 200
✓ API responds in <1s
✓ API returns JSON

Overall success rate of 99.98% across ~12,000 checks. The 2 failures were occasional response time spikes on the homepage and recent topics page under peak load (50 concurrent users), which is a meaningful finding about the system's performance ceiling.

---

Pros

• Easy to set up — standalone binary with minimal configuration needed
• Readable scripting — test scripts are written in plain JavaScript, making them easy to write and maintain
• Detailed metrics — provides response times, error rates, percentiles (p95), and custom thresholds out of the box
• Realistic load simulation — supports staged ramp-up/ramp-down to mimic real traffic patterns
• Clear pass/fail thresholds — can be configured to fail CI pipelines if performance degrades
• No interference with existing mocha/ESLint tooling

Cons

• Not an npm package — requires a separate binary installation, which complicates CI/CD integration compared to npm-based tools
• No browser simulation — tests HTTP endpoints only; doesn't simulate real browser behavior (JS rendering, assets, etc.)
• Requires a live server — cannot be run without a running NodeBB instance, making it harder to integrate into standard unit test pipelines
• Limited to black-box testing — only observes external behavior, gives no insight into internal code paths or memory usage
• Threshold tuning required — default thresholds need manual calibration per project to be meaningful

---