CommonJS Modules: require and module.exports

Advanced CommonJS Modules: require and module.exports in Node.js Tutorial. Deep dive with production-oriented examples—not a shallow overview.

Architecture & mental model

This lesson covers CommonJS Modules: require and module.exports at an intermediate-to-advanced level within Node.js Modules & npm. You will connect Node.js concepts to production constraints: performance, security, testability, and operability.

Advanced learners should already know syntax basics; here we focus on why teams choose specific patterns and how they fail in real systems.

Implementation (production-style)

Type the code below; change names and types to match your domain. Compare with how Node.js teams structure layers in mature codebases.

// CommonJS Modules: require and module.exports — production-style module
export async function runLessonDemo(config) {
  const { endpoint, retries = 2 } = config;
  for (let attempt = 0; attempt <= retries; attempt++) {
    try {
      const res = await fetch(endpoint, { headers: { Accept: 'application/json' } });
      if (!res.ok) throw new Error(`Status ${res.status}`);
      return await res.json();
    } catch (err) {
      if (attempt === retries) throw err;
      await new Promise(r => setTimeout(r, 300 * (attempt + 1)));
    }
  }
}

Decision checklist

• Requirements: What are latency, consistency, and security needs for "CommonJS Modules: require and module.exports"?
• Boundaries: Which layer owns this logic (UI, API, domain, infrastructure)?
• Failure modes: What happens when dependencies time out or return partial data?
• Observability: What logs or metrics prove this feature works in production?

Hands-on lab (45–60 min)

1. Reproduce the primary example for "CommonJS Modules: require and module.exports" in a scratch project using Node.js.
2. Add one automated test (unit or integration) that would fail if you break the core behavior.
3. Introduce a deliberate bug (wrong lifetime, missing await, wrong dependency order) and observe the symptom.
4. Document one trade-off you would present in a design review.

Pitfalls senior engineers avoid

• Treating tutorial demos as production architecture without hardening.
• Skipping observability (logs, metrics, traces) when adding complexity.
• Optimizing before measuring bottlenecks.
• Ignoring team conventions and existing codebase patterns.

Interview depth

Question: Explain CommonJS Modules: require and module.exports to a junior developer in 2 minutes, then list two trade-offs.

Strong answer: Start with the problem it solves, describe one real project usage, mention a failure you debugged or would test for, and close with alternatives (when not to use this approach).

Summary

You completed an advanced treatment of CommonJS Modules: require and module.exports. Revisit after building a feature that uses it end-to-end; spaced repetition with real code beats re-reading alone.