utils-copy-error

Copy Error

Copy an error object.

Installation

$ npm install utils-copy-error

Usage

var copy = require( 'utils-copy-error' );

copy( error )

Copy an error object.

var err1 = new TypeError( 'beep' );

var err2 = copy( err1 );
// returns <TypeError>

Notes

• Supported built-in error types:

  • Error
  • URIError
  • ReferenceError
  • SyntaxError
  • RangeError
  • EvalError
  • TypeError
  • System Error (Node.js)

• The function also supports custom error types which are Error instances (e.g., ES2015 subclasses).

• The function deep copies over all enumerable properties, including property descriptors.

Examples

var copy = require( 'utils-copy-error' );

var err1;
var err2;

err1 = new Error( 'beep' );
err2 = copy( err1 );

console.log( err1 === err2 );
// returns false

console.log( err1.message === err2.message );
// returns true

err1 = new TypeError( 'bad type' );
err2 = copy (err1 );

console.log( err1 === err2 );
// returns false

console.log( err1.stack === err2.stack );
// returns true

err1 = new RangeError( 'invalid value' );
err2 = copy( err1 );

console.log( err1 === err2 );
// returns false

console.log( err1.name === err2.name );
// returns true

To run the example code from the top-level application directory,

$ node ./examples/index.js

Tests

Unit

This repository uses tape for unit tests. To run the tests, execute the following command in the top-level application directory:

$ make test

All new feature development should have corresponding unit tests to validate correct functionality.

Test Coverage

This repository uses Istanbul as its code coverage tool. To generate a test coverage report, execute the following command in the top-level application directory:

$ make test-cov

Istanbul creates a ./reports/coverage directory. To access an HTML version of the report,

$ make view-cov

Browser Support

This repository uses Testling for browser testing. To run the tests in a (headless) local web browser, execute the following command in the top-level application directory:

$ make test-browsers

To view the tests in a local web browser,

$ make view-browser-tests

License

MIT license.

Copyright

Copyright © 2015. Athan Reines.