Check if a value is an `Error` instance.
MIT License
Check if a value is an Error
instance.
This is like value instanceof Error
except it works across realms, such as
iframes or Node.js vm
.
Please reach out if you're looking for a Node.js API or CLI engineer (11 years of experience). Most recently I have been Netlify Build's and Netlify Plugins' technical lead for 2.5 years. I am available for full-time remote positions.
import isErrorInstance from 'is-error-instance'
isErrorInstance(new Error('')) // true
isErrorInstance('') // false
const CrossRealmError = vm.runInNewContext('Error')
isErrorInstance(new CrossRealmError('')) // true
isErrorInstance(new TypeError('')) // true
isErrorInstance(new AnyOtherError('')) // true
isErrorInstance(new DOMException('')) // true
isErrorInstance(new DOMError('')) // true
isErrorInstance(new Proxy(new Error(''), {})) // true
isErrorInstance(
new Proxy(new Error(''), {
getPrototypeOf: () => {
throw new Error('')
},
}),
) // false
npm install is-error-instance
This package works in both Node.js >=18.18.0 and browsers.
This is an ES module. It must be loaded using
an import
or import()
statement,
not require()
. If TypeScript is used, it must be configured to
output ES modules,
not CommonJS.
value
any
Return value: boolean
modern-errors
: Handle errors inerror-custom-class
: Createerror-class-utils
: Utilitieserror-serializer
: Convertmerge-error-cause
: Merge ancause
normalize-exception
:set-error-class
: Properlyset-error-message
: Properlywrap-error-message
:set-error-props
: Properlyset-error-stack
: Properlyerror-cause-polyfill
:error.cause
handle-cli-error
: 💣 Errorlog-process-errors
: Showerror-http-response
:winston-error-format
: LogFor any question, don't hesitate to submit an issue on GitHub.
Everyone is welcome regardless of personal background. We enforce a Code of conduct in order to promote a positive and inclusive environment.
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. Pull requests are welcome!