# @enterprize/exceptions > Generic basic exceptions that are very often used Latest version **1.0.2** (published 2020-01-22) · MIT license · 0 weekly downloads ## Install ```sh npm install @enterprize/exceptions pnpm add @enterprize/exceptions yarn add @enterprize/exceptions bun add @enterprize/exceptions ``` ## Health **Score 20/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.0.2 | | Published | 2020-01-22 | | First published | 2020-01-22 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 13.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 0 | | Author | Giancarlo Dalle Mole | | Maintainers | prophet | | Keywords | Error, Exception, IllegalArgumentException, IllegalStateException, NotImplementeYetException, UnsupportedOperationException | ## Links - npm: https://www.npmjs.com/package/@enterprize/exceptions - Repository: https://github.com/giancarlo-dm/etz-exceptions - Homepage: https://github.com/giancarlo-dm/etz-exceptions#readme - Issues: https://github.com/giancarlo-dm/etz-exceptions/issues - Funding: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=8KT6SPVB84XLY&source=url - npm.io page: https://npm.io/package/@enterprize/exceptions ## Alternatives - [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads - [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads - [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads - [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads - [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads ## Recent versions - 1.0.2 (latest) — 2020-01-22 - 1.0.1 — 2020-01-22 - 1.0.0 — 2020-01-22 ## README # Enterprize Exceptions (etz-exceptions) Tired of using the plain ``Error`` class? Want some common ``Exceptions`` out of the box? Want to add details in an elegant and typed way? Start using ***Enterprize Exceptions***! [![npm version](https://badge.fury.io/js/%40enterprize%2Fexceptions.svg)](https://badge.fury.io/js/%40enterprize%2Fexceptions) # Features Jokes aside :grin:, the following exceptions are implemented out of the box: - ``Exception`` - ``IllegalArgumentException`` - ``IllegalStateException`` - ``NotImplementedYetException`` - ``UnsupportedOperationException`` Extend any of the above to create your custom exception. # Public API ## ``Exception extends Error`` Base class of all exceptions. This class and its subclasses are exceptions that are not considered critical (i.e. they are not catastrophic errors), and the application can be safely recovered if the exception is treated by a try-catch block. Generic types: - ``D``: (optional) The type of the ``details`` argument. Default: ``void`` Inherits: ``Error`` ### Constructors - ``constructor()`` - ``constructor(message: string)`` - ``constructor(message: string, details: D)`` |Arguments|Type|Description| |---|:---:|---| |``message``|``string``|Simple text message. Same parameter as in ``Error``. **Default:** ``"Exception"``| |``details``|``D``|Some data that represents details of the exception. Can be anything.| ### Attributes |Attribute|Type|Description| |---|:---:|---| |``name``|``string``|Name of the error. **Default:** The class name (or its subclass)| |``message``|``string``|Error message. **Default:** ``"Exception"``| |``stack``|``string``|Error stack caputured.| ## ``IllegalArgumentException extends Exception`` Indicates that a method or constructor received an illegal or inappropriate parameter/argument. Generic types: - ``D``: (optional) The type of the ``details`` argument. Default: ``void`` Inherits: [``Exception``](#exceptiond--void-extends-error) Constructors: - ``constructor()`` - ``constructor(message: string)`` - ``constructor(message: string, argumentName: string)`` - ``constructor(message: string, argumentName: string, details: D)`` |Arguments|Type|Description| |---|:---:|---| |``message``|``string``|Simple text message. Same parameter as in ``Error``. **Default:** ``"Exception"``| |``argumentName``|``string``|Name of the argument or parameter that caused the exception.| |``details``|``D``|Some data that represents details of the exception. Can be anything.| ### Attributes See ***Inherits*** for the inherited attributes. |Attribute|Type|Description| |---|:---:|---| |``argumentName``|``string``|Name of the argument that caused the exception.| ## ``IllegalStateException extends Exception`` Signals that a method has been invoked at an illegal or inappropriate time. In other words, the NodeJS environment, NodeJS application or the resource is not in an appropriate state for the requested operation. Generic types: - ``D``: (optional) The type of the ``details`` argument. Default: ``void`` Inherits: [``Exception``](#exceptiond--void-extends-error) Constructors: - ``constructor(message: string)`` - ``constructor(message: string, details: D)`` |Arguments|Type|Description| |---|:---:|---| |``message``|``string``|Simple text message. Same parameter as in ``Error``. **Default:** ``"Exception"``| |``details``|``D``|Some data that represents details of the exception. Can be anything.| ### Attributes See ***Inherits*** for the inherited attributes. ## ``NotImplementedYetException extends Exception`` Indicates that an method/function/constructor is not yet implemented but will be available in the future. Generic types: - ``D``: (optional) The type of the ``details`` argument. Default: ``void`` Inherits: [``Exception``](#exceptiond--void-extends-error) Constructors - ``constructor(message: string)`` - ``constructor(message: string, details: D)`` |Arguments|Type|Description| |---|:---:|---| |``message``|``string``|Simple text message. Same parameter as in ``Error``. **Default:** ``"Exception"``| |``details``|``D``|Some data that represents details of the exception. Can be anything.| ### Attributes See ***Inherits*** for the inherited attributes. ## ``UnsupportedOperationException extends Exception`` Indicates that a given operation is not supported and never will be. Generic types: - ``D``: (optional) The type of the ``details`` argument. Default: ``void`` Inherits: [``Exception``](#exceptiond--void-extends-error) Constructors: - ``constructor(message: string)`` - ``constructor(message: string, reason: string)`` - ``constructor(message: string, reason: string, details: D)`` |Arguments|Type|Description| |---|:---:|---| |``message``|``string``|Simple text message. Same parameter as in ``Error``. **Default:** ``"Exception"``| |``reason``|``string``|The reason for the operation not being supported.| |``details``|``D``|Some data that represents details of the exception. Can be anything.| ### Attributes See ***Inherits*** for the inherited attributes. |Attribute|Type|Description| |---|:---:|---| |``reason``|``string``|The reason for the operation not being supported..| # Sponsor Use my packages in your projects? You think they are awesome? So, help me give more time to develop them by becoming a sponsor. :wink: PayPal - The safer, easier way to pay online! --- _Source: https://npm.io/package/@enterprize/exceptions · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._