err-code
Create new error instances with a code and additional properties.
Installation
$ npm install err-code
// or
$ bower install err-code
The browser file is named index.umd.js which supports CommonJS, AMD and globals (errCode).
Why
I find myself doing this repeatedly:
var err = new Error('My message');
err.code = 'SOMECODE';
err.detail = 'Additional information about the error';
throw err;
Usage
Simple usage.
var errcode = require('err-code');
throw errcode(new Error('My message'), 'ESOMECODE');
throw errcode(new Error('My message'), 'ESOMECODE', { detail: 'Additional information about the error' });
throw errcode(new Error('My message'), { detail: 'Additional information about the error' });
Pre-existing fields
If the passed Error
already has a .code
field, or fields specified in the third argument to errcode
they will be overwritten, unless the fields have been defined as read-only or the Error
object has been frozen.
Tests
$ npm test
License
Released under the MIT License.