JavaScript Error Handling: Try, Catch, and Custom Errors

When I first learned about javascript error handling, I made every mistake possible. This tutorial is the guide I wish I had — clear, practical, and filled with real code.

What is Error Handling?

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

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

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

console.log('Learning: Error Handling');

// 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
// Error Handling in JavaScript

// Example 1: Basic usage
function demonstrateErrorHandling() {
  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;
}

demonstrateErrorHandling();

// 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 Error Handling

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 Error Handling 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 error handling:

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 error handling 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