ember-exex

0.2.0 • Public • Published

Ember-exex: Exceptional Exceptions for ambitious applications

  _____           _                                       
 | ____|_ __ ___ | |__   ___ _ __       _____  _______  __
 |  _| | '_ ` _ \| '_ \ / _ \ '__|____ / _ \ \/ / _ \ \/ /
 | |___| | | | | | |_) |  __/ | |_____|  __/>  <  __/>  < 
 |_____|_| |_| |_|_.__/ \___|_|        \___/_/\_\___/_/\_\
                                                               

Ember Exceptional Exceptions: Customizable error classes and error re-throwing with original error included

Build Status Ember Observer Score npm version

Why ember exex

When building advanced javascript application full featured error handling is required, but unfortunately it is not provided in javascript out of the box. Taste flavor of Java like exceptions in javascript:

  • Custom error classes
  • Re-throwing of an error with additional context and original error
  • Additonal tooling

Console example

alt tag

Compatiblity

Build Status

Install

ember install ember-exex

Multiple error classes with inheritance

 
import {defineError} from 'ember-exex/error';
 
const ApplicationError = defineError({
    name: 'ApplicationError', 
    message: 'General application error'
});
 
const ServiceError = defineError({
    name: 'ServiceError', 
    message: 'Service error', 
    extends: ApplicationError
});
 
const UserInterfaceError = defineError({
    name: 'UserInterfaceError', 
    message: 'Service error', 
    extends: ApplicationError
});
 
try {
    throw new UserInterfaceError();
} catch (e) {
 
    console.log(instanceof UserInterfaceError); // true
    console.log(instanceof ApplicationError); // true
    console.log(instanceof Error); // true
    console.log(instanceof ServiceError); // false
    
    if (instanceof UserInterfaceError) {
        resolveUserInterfaceError(e);
    } else if (instanceof ServiceError) {
        resolveServiceError(e);
    } else if (instanceof ApplicationError) {
        resolveGenericApplicationError(e);
    } else if (instanceof Error) {
        resolveGenericError(e);
    }
}

Re-throwing error with wrapped catched error

 
import {defineError} from 'ember-exex/error';
 
const DatabaseError = defineError({
    name: 'DatabaseError', 
    message: 'Database error', 
    extends: ApplicationError
});
      
const UserInterfaceError = defineError({
    name: 'UserInterfaceError', 
    message: 'Service error', 
    extends: ApplicationError
});
 
try {
    throw new DatabaseError('Database IO error')
} catch (e) {
    throw new UserInterfaceError('Cannot render user interface')
        .withPreviousError(e);
}

Wrapped error is included as string in error.stack and stored as property on wrapping error error.previous

Parametrized error messages

 
import {defineError} from 'ember-exex/error';
 
const DatabaseError = defineError({
    name: 'DatabaseError', 
    message: "Database IO error at table '{table}' in '{db}'"
});
 
try {
    throw new DatabaseError({params: {db: 'mydb', table: 'posts'}});
} catch (e) {
    console.log(e.message); // Database IO error at 'posts' in 'mydb'
}

Extending errors

 
import {defineError} from 'ember-exex/error';
 
const ServiceError = defineError({
     name: 'ServiceError', 
     resolve: function() {
         GlobalExceptionManager.log(this);
     }
});
 
try {
    throw new ServiceError();
} catch (e) {
    if (instanceof ServiceError) {
        e.resolve();
    } else {
        // do something else
    }
}

Package Sidebar

Install

npm i ember-exex

Weekly Downloads

101

Version

0.2.0

License

MIT

Unpacked Size

261 kB

Total Files

24

Last publish

Collaborators

  • janmisek