make-error

   

> Make your own error types!

Features

- Compatible Node & browsers
- instanceof support
- error.name & error.stack support
- compatible with CSP (i.e. no eval())

Installation

$3

Installation of the npm package:

``
> npm install --save make-error
`

Then require the package:

`javascript
var makeError = require("make-error");
`

$3

You can directly use the build provided at unpkg.com:

`html

`

Usage

$3

`javascript
var CustomError = makeError("CustomError");

// Parameters are forwarded to the super class (here Error).
throw new CustomError("a message");
`

$3

`javascript
function CustomError(customValue) {
CustomError.super.call(this, "custom error message");

this.customValue = customValue;
}
makeError(CustomError);

// Feel free to extend the prototype.
CustomError.prototype.myMethod = function CustomError$myMethod() {
console.log("CustomError.myMethod (%s, %s)", this.code, this.message);
};

//-----

try {
throw new CustomError(42);
} catch (error) {
error.myMethod();
}
`

$3

`javascript
var SpecializedError = makeError("SpecializedError", CustomError);

throw new SpecializedError(42);
`

$3

> Best for ES2015+.

`javascript
import { BaseError } from "make-error";

class CustomError extends BaseError {
constructor() {
super("custom error message");
}
}
``

Related

- make-error-cause: Make your own error types, with a cause!

Contributions

Contributions are _very_ welcomed, either on the documentation or on
the code.

You may:

- report any issue
you've encountered;
- fork and create a pull request.

License

ISC © Julien Fontanet