nodejs

✓Verified·Scanned 3/18/2026

Write reliable Node.js avoiding event loop blocking, async pitfalls, ESM gotchas, and memory leaks.

from clawhub.ai·v1.0.1·6.3 KB·0 installs
$ vett add clawhub.ai/ivangdavila/nodejs

Quick Reference

TopicFile
Callbacks, Promises, async/await, event loopasync.md
CommonJS vs ESM, require vs importmodules.md
Error handling, uncaught exceptionserrors.md
Readable, Writable, Transform, backpressurestreams.md
Memory leaks, event loop blocking, profilingperformance.md
Input validation, dependencies, env varssecurity.md
Jest, Mocha, mocking, integration teststesting.md
npm, package.json, lockfiles, publishingpackages.md

Critical Traps

  • fs.readFileSync blocks entire server — use fs.promises.readFile
  • Unhandled rejection crashes Node 15+ — always .catch() or try/catch
  • process.env values are strings — "3000" not 3000, parseInt needed
  • JSON.parse throws on invalid — wrap in try/catch
  • require() cached — same object, mutations visible everywhere
  • Circular deps return incomplete export — restructure to avoid
  • Event listeners accumulate — removeListener or once()
  • async always returns Promise — even for plain return
  • pipeline() over .pipe() — handles errors and cleanup
  • No __dirname in ESM — use fileURLToPath(import.meta.url)
  • Buffer.from(string) — encoding matters, default UTF-8