JavaScript Modules: import, export, and Dynamic Imports

I've been teaching javascript modules for years, and the #1 question I get is: "How does this actually work in practice?" This guide answers that question with real examples.

What is Modules?

Understanding modules is essential for any JavaScript developer. It's one of those concepts that separates beginners from professionals.

In this guide, we'll explore modules through practical examples that you can use in your projects today.

// Quick demonstration of Modules
// This example shows the core concept in action

console.log('Learning: Modules');

// We will build up from this basic example
// to production-ready patterns

Core Concepts

Let's break down the core concepts with clear, runnable examples:

// Core concept demonstration
// Modules in JavaScript

// Example 1: Basic usage
function demonstrateModules() {
  const data = ['hello', 'world', 'javascript'];

  // Process each item
  const processed = data.map(item => {
    return item.charAt(0).toUpperCase() + item.slice(1);
  });

  console.log('Processed:', processed);
  return processed;
}

demonstrateModules();

// Example 2: With error handling
function safeOperation(input) {
  if (!input || typeof input !== 'string') {
    throw new TypeError('Expected a non-empty string');
  }
  return input.trim().toLowerCase();
}

try {
  console.log(safeOperation('  Hello World  '));
  console.log(safeOperation(null)); // Throws!
} catch (error) {
  console.error(`Error: ${error.message}`);
}

Practical Examples

Building a Practical Example

// Real-world application of Modules

class DataProcessor {
  constructor(data) {
    this.data = data;
    this.history = [];
  }

  filter(predicate) {
    this.history.push([...this.data]);
    this.data = this.data.filter(predicate);
    return this; // Enable method chaining
  }

  transform(fn) {
    this.history.push([...this.data]);
    this.data = this.data.map(fn);
    return this;
  }

  sort(compareFn) {
    this.history.push([...this.data]);
    this.data = [...this.data].sort(compareFn);
    return this;
  }

  undo() {
    if (this.history.length > 0) {
      this.data = this.history.pop();
    }
    return this;
  }

  get result() {
    return [...this.data];
  }
}

// Usage
const items = [
  { name: 'Alpha', value: 30 },
  { name: 'Beta', value: 10 },
  { name: 'Gamma', value: 50 },
  { name: 'Delta', value: 20 },
];

const result = new DataProcessor(items)
  .filter(item => item.value > 15)
  .sort((a, b) => b.value - a.value)
  .transform(item => ({ ...item, label: `${item.name}: ${item.value}` }))
  .result;

console.log(result);

Advanced Patterns

Production-Ready Pattern

// Advanced Modules pattern with error handling and caching

class SmartCache {
  #cache = new Map();
  #maxSize;
  #ttl;

  constructor({ maxSize = 100, ttlMs = 60000 } = {}) {
    this.#maxSize = maxSize;
    this.#ttl = ttlMs;
  }

  set(key, value) {
    // Remove oldest entry if at capacity
    if (this.#cache.size >= this.#maxSize) {
      const oldest = this.#cache.keys().next().value;
      this.#cache.delete(oldest);
    }
    this.#cache.set(key, {
      value,
      expires: Date.now() + this.#ttl
    });
  }

  get(key) {
    const entry = this.#cache.get(key);
    if (!entry) return undefined;
    if (Date.now() > entry.expires) {
      this.#cache.delete(key);
      return undefined;
    }
    return entry.value;
  }

  has(key) {
    return this.get(key) !== undefined;
  }

  clear() {
    this.#cache.clear();
  }

  get size() {
    return this.#cache.size;
  }
}

// Usage
const cache = new SmartCache({ maxSize: 50, ttlMs: 30000 });
cache.set('user:1', { name: 'Alice' });
console.log(cache.get('user:1')); // { name: 'Alice' }
// After 30 seconds: cache.get('user:1') → undefined

Common Mistakes to Avoid

Here are the most common pitfalls developers encounter with modules:

1. Not handling edge cases — Always validate inputs and handle null/undefined
2. Ignoring async behavior — JavaScript is single-threaded but async — respect the event loop
3. Memory leaks — Clean up event listeners and references when components unmount
4. Over-engineering — Start simple, refactor when needed

Summary and Next Steps

You now have a solid understanding of modules in JavaScript. Here's what to do next:

• Practice by building a small project that uses these concepts
• Read the MDN documentation for deeper details
• Experiment with edge cases to build intuition
• Teach someone else — it's the best way to solidify your knowledge