113 lines
2.6 KiB
Markdown
113 lines
2.6 KiB
Markdown
|
# make-error
|
||
|
|
|
||
|
|
[](https://npmjs.org/package/make-error) [](https://travis-ci.org/JsCommunity/make-error) [](https://packagephobia.now.sh/result?p=make-error) [](https://github.com/JsCommunity/make-error/commits/master)
|
||
|
|
|
||
|
|
> Make your own error types!
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- Compatible Node & browsers
|
||
|
|
- `instanceof` support
|
||
|
|
- `error.name` & `error.stack` support
|
||
|
|
- compatible with [CSP](https://en.wikipedia.org/wiki/Content_Security_Policy) (i.e. no `eval()`)
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
### Node & [Browserify](http://browserify.org/)/[Webpack](https://webpack.js.org/)
|
||
|
|
|
||
|
|
Installation of the [npm package](https://npmjs.org/package/make-error):
|
||
|
|
|
||
|
|
```
|
||
|
|
> npm install --save make-error
|
||
|
|
```
|
||
|
|
|
||
|
|
Then require the package:
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
var makeError = require("make-error");
|
||
|
|
```
|
||
|
|
|
||
|
|
### Browser
|
||
|
|
|
||
|
|
You can directly use the build provided at [unpkg.com](https://unpkg.com):
|
||
|
|
|
||
|
|
```html
|
||
|
|
<script src="https://unpkg.com/make-error@1/dist/make-error.js"></script>
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
### Basic named error
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
var CustomError = makeError("CustomError");
|
||
|
|
|
||
|
|
// Parameters are forwarded to the super class (here Error).
|
||
|
|
throw new CustomError("a message");
|
||
|
|
```
|
||
|
|
|
||
|
|
### Advanced error class
|
||
|
|
|
||
|
|
```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();
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Specialized error
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
var SpecializedError = makeError("SpecializedError", CustomError);
|
||
|
|
|
||
|
|
throw new SpecializedError(42);
|
||
|
|
```
|
||
|
|
|
||
|
|
### Inheritance
|
||
|
|
|
||
|
|
> Best for ES2015+.
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
import { BaseError } from "make-error";
|
||
|
|
|
||
|
|
class CustomError extends BaseError {
|
||
|
|
constructor() {
|
||
|
|
super("custom error message");
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [make-error-cause](https://www.npmjs.com/package/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](https://github.com/JsCommunity/make-error/issues)
|
||
|
|
you've encountered;
|
||
|
|
- fork and create a pull request.
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
ISC © [Julien Fontanet](http://julien.isonoe.net)
|