[d24f17c] | 1 | # DOMException
|
---|
| 2 | An implementation of the DOMException class from NodeJS
|
---|
| 3 |
|
---|
| 4 | This package implements the [`DOMException`](https://developer.mozilla.org/en-US/docs/Web/API/DOMException) class, from NodeJS itself.
|
---|
| 5 | NodeJS has DOMException built in, but it's not globally available, and you can't require/import it from somewhere.
|
---|
| 6 |
|
---|
| 7 | The only possible way is to use some web-ish tools that have been introduced into NodeJS that throws an error and catch the constructor.
|
---|
| 8 | This way you will have the same class that NodeJS has and you can check if the error is a instance of DOMException.
|
---|
| 9 | The instanceof check would not have worked with a custom class such as the DOMexception provided by domenic which also is much larger in size.
|
---|
| 10 |
|
---|
| 11 | ```js
|
---|
| 12 | import DOMException from 'node-domexception'
|
---|
| 13 |
|
---|
| 14 | hello().catch(err => {
|
---|
| 15 | if (err instanceof DOMException) {
|
---|
| 16 | ...
|
---|
| 17 | }
|
---|
| 18 | })
|
---|
| 19 |
|
---|
| 20 | const e1 = new DOMException("Something went wrong", "BadThingsError");
|
---|
| 21 | console.assert(e1.name === "BadThingsError");
|
---|
| 22 | console.assert(e1.code === 0);
|
---|
| 23 |
|
---|
| 24 | const e2 = new DOMException("Another exciting error message", "NoModificationAllowedError");
|
---|
| 25 | console.assert(e2.name === "NoModificationAllowedError");
|
---|
| 26 | console.assert(e2.code === 7);
|
---|
| 27 |
|
---|
| 28 | console.assert(DOMException.INUSE_ATTRIBUTE_ERR === 10);
|
---|
| 29 | ```
|
---|
| 30 |
|
---|
| 31 | ## APIs
|
---|
| 32 |
|
---|
| 33 | This package exposes two flavors of the `DOMException` interface depending on the imported module.
|
---|
| 34 |
|
---|
| 35 | ### `domexception` module
|
---|
| 36 |
|
---|
| 37 | This module default-exports the `DOMException` interface constructor.
|
---|
| 38 |
|
---|
| 39 | ### `domexception/webidl2js-wrapper` module
|
---|
| 40 |
|
---|
| 41 | This module exports the `DOMException` [interface wrapper API](https://github.com/jsdom/webidl2js#for-interfaces) generated by [webidl2js](https://github.com/jsdom/webidl2js).
|
---|