Custom Error Hierarchies & Prototypes0%
Error Boundaries & Global Exception Catching

Custom Error Hierarchies & Prototypes

Beginner12 min read•Updated: Jul 11, 2026
Study Materials

Custom Error Hierarchies & Prototypes in Modern JavaScript

In enterprise architectures, generic exceptions like Error("something broke") make debugging difficult. Designing a domain-specific Custom Error Hierarchy enables precise error categorization, structured error codes, telemetry metadata, and robust prototype chain restoration across transpilers.

1. Designing an Enterprise Error Hierarchy

A well-structured system categorizes errors into clear inheritance tiers:

Output
┌───────────────┐
│ built-in Error│
└───────┬───────┘
│ extends
┌───────▼───────┐
│ AppBaseError │ (Captures timestamp, code, HTTP status)
└───────┬───────┘
┌──────────────────┼──────────────────┐
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ ValidationError│ │ AuthError │ │ DatabaseError│
└──────────────┘ └──────────────┘ └──────────────┘

2. Implementing the Base Application Error

JavaScript
class AppBaseError extends Error {
constructor(message, options = {}) {
// Pass message and options (supports ES2022 cause) to super
super(message, options);
 
// Explicitly configure error name to match class name
this.name = this.constructor.name;
this.statusCode = options.statusCode || 500;
this.errorCode = options.errorCode || 'INTERNAL_ERROR';
this.timestamp = new Date().toISOString();
this.isOperational = true; // Distinguishes operational vs programmer bugs
 
// Capture clean stack trace omitting constructor frame (V8 engine)
if (Error.captureStackTrace) {
Error.captureStackTrace(this, this.constructor);
}
}
 
toJSON() {
return {
name: this.name,
message: this.message,
errorCode: this.errorCode,
statusCode: this.statusCode,
timestamp: this.timestamp
};
}
}

3. Creating Domain-Specific Specialized Subclasses

JavaScript
class ValidationError extends AppBaseError {
constructor(message, validationErrors = []) {
super(message, { statusCode: 400, errorCode: 'VALIDATION_FAILED' });
this.validationErrors = validationErrors;
}
}
 
class AuthenticationError extends AppBaseError {
constructor(message = 'Authentication credentials invalid or missing.') {
super(message, { statusCode: 401, errorCode: 'UNAUTHORIZED' });
}
}
 
class EntityNotFoundError extends AppBaseError {
constructor(entityName, id) {
super(`Resource ${entityName} with ID '${id}' was not found.`, {
statusCode: 404,
errorCode: 'RESOURCE_NOT_FOUND'
});
this.entityName = entityName;
this.id = id;
}
}

4. The Transpiler Prototype Chain Pitfall (TypeScript & Babel)

When compiling ES6 classes down to ES5, subclassing built-in classes like Error can break instanceof checks because the prototype chain is not linked properly.

Solution: Explicit Prototype Restoration

JavaScript
class SafeCustomError extends Error {
constructor(msg) {
super(msg);
// Explicitly restore prototype chain:
Object.setPrototypeOf(this, new.target.prototype);
}
}

5. Operational vs. Programmer Errors

In production servers (Node.js/Express):

  • Operational Errors: Known runtime failure conditions (e.g. invalid password, file not found, network timeout). Can be handled gracefully (isOperational: true).
  • Programmer Errors: Bugs in code (e.g. calling undefined(), passing wrong types). Require logging to Sentry and restarting the worker process to avoid corrupted state.
Interactive Quiz

Practice Quiz

Question 1
What does V8's Error.captureStackTrace(this, constructor) achieve?
Question 2
Why is Object.setPrototypeOf(this, new.target.prototype) sometimes required when subclassing Error?
Question 3
What is the benefit of defining an isOperational: true flag on custom application errors?
Question 4
How does setting this.name = this.constructor.name inside a base error class improve debugging?
Question 5
How can a custom error class support serializing structured error responses to JSON?
Next Lesson

Error Boundaries & Global Exception Catching

Continue learning with hands-on practice, examples, and exercises in the upcoming topic.

Related Lessons

Previous LessonNext Lesson
Web Workers & Multithreading in JSError Boundaries & Global Exception Catching

Practice Quiz

Test your understanding of this lesson with 5 questions. Each question has one correct answer.

PreviousNext
PrevNext