NodeJS

name: NodeJS slug: nodejs version: 1.0.1 description: Write reliable Node.js avoiding event loop blocking, async pitfalls, ESM gotchas, and memory leaks. metadata: {"clawdbot":{"emoji":"💚","requires":{"bins":["node"]},"os":["linux","darwin","win32"]}}

Quick Reference

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