err
A tiny library to create custom errors in JavaScript.
☁️ Installation
# Using npm npm install --save err # Using yarn yarn add err
📋 Example
const Err = ; // Basic usagelet e1 = "Some nasty stuff happened";console;// => [Error: Some nasty stuff happened] // Provide the error codelet e2 = "Some nasty stuff happened" "NASTY_STUFF_HAPPENED";console;// => {// [Error: Some nasty stuff happened]// code: 'NASTY_STUFF_HAPPENED'// } // Provide the error code and some datalet e3 = "Some nasty stuff happened" "NASTY_STUFF_HAPPENED" additional: "data";console;// => {// [Error: Some nasty stuff happened]// additional: 'data'// , code: 'NASTY_STUFF_HAPPENED'// } // Provide the error data (including the code as well)let e4 = "Some nasty stuff happened" additional: "data" code: "NASTY_STUFF_HAPPENED";console;// => {// [Error: Some nasty stuff happened]// additional: 'data'// , code: 'NASTY_STUFF_HAPPENED'// } // Wrap an existing errorlet existingError = "Some nasty stuff happened";let e5 = existingError additional: "data" code: "NASTY_STUFF_HAPPENED" and: "some more data";console;// => {// [Error: Some nasty stuff happened]// additional: 'data'// , code: 'NASTY_STUFF_HAPPENED'// , and: 'some more data'// } let e6 = message: "Something went really wrong!!!" additional: "data" code: "NASTY_STUFF_HAPPENED" and: "some more data";console;// => {// [Error: Something went really wrong!!!]// additional: 'data'// , code: 'NASTY_STUFF_HAPPENED'// , and: 'some more data'// } let e7 = "Invalid option '<option>'." option: "test";console;// { [Error: Invalid option 'test'.] option: 'test' }
❓ Get Help
There are few ways to get help:
- Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
- For bug reports and feature requests, open issues. 🐛
- For direct and quick help, you can use Codementor. 🚀
📝 Documentation
Err(error, code, data)
Create a custom error object.
Params
- String|Error|Object
error
: The error message or an existingError
instance or thedata
object where themessage
is the error message. - String|Object
code
: The error code or the data object. - Object
data
: The data object (its fields will be appended to theError
object).
Return
- Error The custom
Error
instance.
😋 How to contribute
Have an idea? Found a bug? See how to contribute.
💖 Support my projects
I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously, this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).
However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:
-
Starring and sharing the projects you like 🚀
-
—I love books! I will remember you after years if you buy me one. 😁 📖
-
—You can make one-time donations via PayPal. I'll probably buy a
coffeetea. 🍵 -
—Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).
-
Bitcoin—You can send me bitcoins at this address (or scanning the code below):
1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6
Thanks! ❤️
💫 Where is this library used?
If you are using this library in one of your projects, add it in this list. ✨
scrape-it
tilda
emoji-logger
@sphinxdoc/core
bloggify-adapter
python-env
image-parser
validated-base
find-file-in-dirs
@asserted/models
git-package-json
multithread-config
@ecosystem/config
mocha-ldjson
engine-comp-crud-errors
engine-composition-adapter
fs-repo-url
gh-fork-source
lwip2
validify
sphinxdoc
@gatsbydoc/core
simple-cached-firestore
payiota
stringify-env
scrape-it-plus
@slikts/scrape-it
do-task
check-params
love-you
showalicense.com
@sphinxdoc/cli
trace-breaking-change
@reactant/react-router
@gatsbydoc/sphinx
@gatsbydoc/cli
vkbeautify-cli
dotstow
ts-gir
simple-cached-datastore
git-sync-all
@ecosystem/core
asrtd
hunarcourses