# error-custom-class > Create custom error classes Latest version **10.0.1** (published 2025-03-29) · MIT license · 0 weekly downloads ## Install ```sh npm install error-custom-class pnpm add error-custom-class yarn add error-custom-class bun add error-custom-class ``` ## Health **Score 55/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. Negative: stale. ## Facts | | | |---|---| | Version | 10.0.1 | | Published | 2025-03-29 | | First published | 2022-08-26 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=18.18.0 | | Dependencies | 1 | | Unpacked size | 9.6 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 5 | | Author | ehmicky | | Maintainers | ehmicky | | Keywords | nodejs, javascript, stacktrace, library, typescript, browser, errors, monitoring, error-monitoring, custom, message, error-handler, properties, error, error-handling, code-quality, create, cause, error-reporting, error-classes | ## Links - npm: https://www.npmjs.com/package/error-custom-class - Repository: https://github.com/ehmicky/error-custom-class - Homepage: https://www.github.com/ehmicky/error-custom-class - Issues: https://github.com/ehmicky/error-custom-class/issues - npm.io page: https://npm.io/package/error-custom-class ## Dependencies (1) - [error-class-utils](https://npm.io/package/error-class-utils.md) ^4.0.1 ## 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 - 10.0.1 (latest) — 2025-03-29 - 10.0.0 — 2023-10-28 - 9.0.0 — 2023-05-13 - 8.4.0 — 2022-11-11 - 8.3.0 — 2022-11-07 - 8.2.1 — 2022-10-13 - 8.2.0 — 2022-10-13 - 8.1.0 — 2022-09-05 - 8.0.0 — 2022-09-05 - 7.0.0 — 2022-09-05 - 6.0.0 — 2022-09-01 - 5.0.0 — 2022-08-31 - 4.1.0 — 2022-08-31 - 4.0.0 — 2022-08-26 ## README [![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js&colorA=404040&logoColor=66cc33)](https://www.npmjs.com/package/error-custom-class) [![Browsers](https://img.shields.io/badge/-Browsers-808080?logo=firefox&colorA=404040)](https://unpkg.com/error-custom-class?module) [![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript&colorA=404040&logoColor=0096ff)](/src/main.d.ts) [![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov&colorA=404040)](https://codecov.io/gh/ehmicky/error-custom-class) [![Minified size](https://img.shields.io/bundlephobia/minzip/error-custom-class?label&colorA=404040&colorB=808080&logo=webpack)](https://bundlephobia.com/package/error-custom-class) [![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon&colorA=404040&logoColor=9590F9)](https://fosstodon.org/@ehmicky) [![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium&colorA=404040)](https://medium.com/@ehmicky) Create custom error classes. # Features - [Very simple API](#api) - Ponyfill [`error.cause`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/cause) on [older Node.js and browsers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/cause#browser_compatibility) - Properly [set `error.name`](https://github.com/ehmicky/error-class-utils#seterrornameerrorclass-name) - Fix [issues](https://github.com/ehmicky/error-class-utils#ensurecorrectclasserror-newtarget) when `Error` has been polyfilled # Example ```js import errorCustomClass from 'error-custom-class' const UserError = errorCustomClass('UserError') const DatabaseError = errorCustomClass('DatabaseError') try { throw new UserError('message') } catch (error) { console.log(error.name) // 'UserError' console.log(error instanceof UserError) // true } ``` # Install ```bash npm install error-custom-class ``` This package works in both Node.js >=18.18.0 and [browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist). This is an ES module. It must be loaded using [an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c), not `require()`. If TypeScript is used, it must be configured to [output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html), not CommonJS. # API The API is designed for simplicity. For more customization, [`error-class-utils`](https://github.com/ehmicky/error-class-utils) should be used instead. ## errorCustomClass(errorName) `errorName` `string`\ _Return value_: `CustomError` Creates a custom error class. # Related projects - [`modern-errors`](https://github.com/ehmicky/modern-errors): Handle errors in a simple, stable, consistent way - [`error-class-utils`](https://github.com/ehmicky/error-class-utils): Utilities to properly create error classes - [`error-serializer`](https://github.com/ehmicky/error-serializer): Convert errors to/from plain objects - [`normalize-exception`](https://github.com/ehmicky/normalize-exception): Normalize exceptions/errors - [`is-error-instance`](https://github.com/ehmicky/is-error-instance): Check if a value is an `Error` instance - [`merge-error-cause`](https://github.com/ehmicky/merge-error-cause): Merge an error with its `cause` - [`set-error-class`](https://github.com/ehmicky/set-error-class): Properly update an error's class - [`set-error-message`](https://github.com/ehmicky/set-error-message): Properly update an error's message - [`wrap-error-message`](https://github.com/ehmicky/wrap-error-message): Properly wrap an error's message - [`set-error-props`](https://github.com/ehmicky/set-error-props): Properly update an error's properties - [`set-error-stack`](https://github.com/ehmicky/set-error-stack): Properly update an error's stack - [`error-cause-polyfill`](https://github.com/ehmicky/error-cause-polyfill): Polyfill `error.cause` - [`handle-cli-error`](https://github.com/ehmicky/handle-cli-error): 💣 Error handler for CLI applications 💥 - [`log-process-errors`](https://github.com/ehmicky/log-process-errors): Show some ❤ to Node.js process errors - [`error-http-response`](https://github.com/ehmicky/error-http-response): Create HTTP error responses - [`winston-error-format`](https://github.com/ehmicky/winston-error-format): Log errors with Winston # Support For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues). Everyone is welcome regardless of personal background. We enforce a [Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and inclusive environment. # Contributing This project was made with ❤️. The simplest way to give back is by starring and sharing it online. If the documentation is unclear or has a typo, please click on the page's `Edit` button (pencil icon) and suggest a correction. If you would like to help us fix a bug or add a new feature, please check our [guidelines](CONTRIBUTING.md). Pull requests are welcome! --- _Source: https://npm.io/package/error-custom-class · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._