{"id":28484261,"url":"https://github.com/ehmicky/modern-errors-beautiful","last_synced_at":"2026-03-03T22:01:07.968Z","repository":{"id":294746679,"uuid":"987956346","full_name":"ehmicky/modern-errors-beautiful","owner":"ehmicky","description":"`modern-errors` plugin to prettify errors.","archived":false,"fork":false,"pushed_at":"2026-03-01T21:32:22.000Z","size":2185,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-02T00:53:24.591Z","etag":null,"topics":["bash","browser","cli","console","errors","handler","javascript","library","message","modern-errors","modern-errors-plugin","monitoring","nodejs","plugins","shell","stack","stacktrace","terminal","timeout","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ehmicky.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-21T20:54:46.000Z","updated_at":"2026-03-01T21:32:20.000Z","dependencies_parsed_at":"2025-05-21T21:39:07.252Z","dependency_job_id":"7960acc8-ef0c-4460-bd0a-96d983dce007","html_url":"https://github.com/ehmicky/modern-errors-beautiful","commit_stats":null,"previous_names":["ehmicky/modern-errors-beautiful"],"tags_count":4,"template":false,"template_full_name":"ehmicky/template-javascript","purl":"pkg:github/ehmicky/modern-errors-beautiful","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-beautiful","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-beautiful/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-beautiful/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-beautiful/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehmicky","download_url":"https://codeload.github.com/ehmicky/modern-errors-beautiful/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-beautiful/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30063348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T18:21:05.932Z","status":"ssl_error","status_checked_at":"2026-03-03T18:20:59.341Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","browser","cli","console","errors","handler","javascript","library","message","modern-errors","modern-errors-plugin","monitoring","nodejs","plugins","shell","stack","stacktrace","terminal","timeout","typescript"],"created_at":"2025-06-07T22:06:39.161Z","updated_at":"2026-03-03T22:01:07.962Z","avatar_url":"https://github.com/ehmicky.png","language":"TypeScript","readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/ehmicky/design/main/modern-errors/modern-errors_dark.svg\"/\u003e\n  \u003cimg alt=\"modern-errors logo\" src=\"https://raw.githubusercontent.com/ehmicky/design/main/modern-errors/modern-errors.svg\" width=\"600\"/\u003e\n\u003c/picture\u003e\n\n[![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js\u0026colorA=404040\u0026logoColor=66cc33)](https://www.npmjs.com/package/modern-errors-beautiful)\n[![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript\u0026colorA=404040\u0026logoColor=0096ff)](/src/main.ts)\n[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov\u0026colorA=404040)](https://codecov.io/gh/ehmicky/modern-errors-beautiful)\n[![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon\u0026colorA=404040\u0026logoColor=9590F9)](https://fosstodon.org/@ehmicky)\n[![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium\u0026colorA=404040)](https://medium.com/@ehmicky)\n\n[`modern-errors`](https://github.com/ehmicky/modern-errors)\n[plugin](https://github.com/ehmicky/modern-errors#-plugins) to prettify errors.\n\nThis adds [`BaseError.beautiful(error)`](#baseerrorbeautifulerror) which\nprettifies error messages and stacks.\n\n# Features\n\n- 🖍️ Pretty [colors](#%EF%B8%8F-colors), [icons](#-icon) and [header](#-header)\n- ⛑️ [Normalize](https://github.com/ehmicky/normalize-exception) invalid errors\n- 🔕 Log verbosity: [stack](#-stack), [nested errors](#-cause),\n  [properties](#-props)\n- 💥 Exception-safe\n\n# Screenshot\n\n\u003cimg alt=\"modern-errors-beautiful screenshot\" src=\"https://raw.githubusercontent.com/ehmicky/handle-cli-error/main/docs/screenshot.png\" width=\"500\"/\u003e\n\n# Example\n\n[Adding the plugin](https://github.com/ehmicky/modern-errors#adding-plugins) to\n[`modern-errors`](https://github.com/ehmicky/modern-errors).\n\n```js\nimport ModernError from 'modern-errors'\n\nimport modernErrorsBeautiful from 'modern-errors-beautiful'\n\nexport const BaseError = ModernError.subclass('BaseError', {\n  plugins: [modernErrorsBeautiful],\n})\n// ...\n```\n\nPrettifying the error.\n\n```js\ntry {\n  // ...\n} catch (error) {\n  const message = BaseError.beautiful(error)\n  console.error(message)\n}\n```\n\n# Install\n\n```bash\nnpm install modern-errors-beautiful\n```\n\nThis package requires Node.js \u003e=18.18.0.\n\nThis is an ES module. It must be loaded using\n[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),\nnot `require()`. If TypeScript is used, it must be configured to\n[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),\nnot CommonJS.\n\n# API\n\n## modernErrorsBeautiful\n\n_Type_: `Plugin`\n\nPlugin object to pass to the\n[`plugins` option](https://github.com/ehmicky/modern-errors#adding-plugins) of\n`ErrorClass.subclass()`.\n\n## BaseError.beautiful(error)\n\n`error`: `any`\\\n_Return value_: `string`\n\nReturns `error` as a prettified string.\n\nThis never throws. Invalid errors are silently\n[normalized](https://github.com/ehmicky/normalize-exception).\n\n## Options\n\n_Type_: `object`\n\n### 📕 stack\n\n_Type_: `boolean`\\\n_Default_: `true`\n\nWhether to show the error's stack trace.\n\n#### 🪏 cause\n\n_Type_: `boolean`\\\n_Default_: `true`\n\nWhether to show\n[aggregate errors](https://github.com/ehmicky/modern-errors#aggregate-errors).\n\n### 📢 props\n\n_Type_: `boolean`\\\n_Default_: `true`\n\nWhether to show the error's additional properties.\n\n### 🖍️ colors\n\n_Type_: `boolean`\\\n_Default_: `true` in terminals, `false` otherwise\n\nWhether to colorize the error's message, stack trace and additional properties.\n\nQuoted strings in the error's message are printed in bold (for `\"...\"` and\n`'...'`) and in italic (for `` `...` ``).\n\n### ❌ icon\n\n_Type_: `string`\\\n_Default_: `'cross'`\n\nIcon prepended to the error's name. The available values are listed\n[here](https://github.com/sindresorhus/figures/blob/main/readme.md#figures-1).\nCan be disabled by passing an empty string.\n\n### 💄 header\n\n_Type_: `string`\\\n_Default_: `'red bold'`\n\nColor/style of the error's [icon](#-icon) and name. The available values are\nlisted [here](https://github.com/ehmicky/chalk-string#available-styles). Several\nstyles can be specified by using spaces. Can be disabled by passing an empty\nstring.\n\n## Configuration\n\n[Options](#options) can apply to (in priority order):\n\n- Any error: second argument to\n  [`ModernError.subclass()`](https://github.com/ehmicky/modern-errors#options-1)\n\n```js\nexport const BaseError = ModernError.subclass('BaseError', {\n  plugins: [modernErrorsBeautiful],\n  beautiful: options,\n})\n```\n\n- Any error of a specific class (and its subclasses): second argument to\n  [`ErrorClass.subclass()`](https://github.com/ehmicky/modern-errors#options-1)\n\n```js\nexport const InputError = BaseError.subclass('InputError', {\n  beautiful: options,\n})\n```\n\n- A specific error: second argument to\n  [`new ErrorClass()`](https://github.com/ehmicky/modern-errors#options-3)\n\n```js\nthrow new InputError('...', { beautiful: options })\n```\n\n- A specific [`BaseError.beautiful(error)`](#baseerrorbeautifulerror) call\n\n```js\nBaseError.beautiful(error, options)\n```\n\n# Related projects\n\n- [`handle-cli-error`](https://github.com/ehmicky/handle-cli-error): 💣 Error\n  handler for CLI applications 💥\n- [`beautiful-error`](https://github.com/ehmicky/beautiful-error): Prettify\n  error messages and stacks\n- [`modern-errors`](https://github.com/ehmicky/modern-errors): Handle errors in\n  a simple, stable, consistent way\n- [`modern-errors-process`](https://github.com/ehmicky/modern-errors-process):\n  Handle process errors\n- [`modern-errors-bugs`](https://github.com/ehmicky/modern-errors-bugs): Print\n  where to report bugs\n- [`modern-errors-serialize`](https://github.com/ehmicky/modern-errors-serialize):\n  Serialize/parse errors\n- [`modern-errors-clean`](https://github.com/ehmicky/modern-errors-clean): Clean\n  stack traces\n- [`modern-errors-http`](https://github.com/ehmicky/modern-errors-http): Create\n  HTTP error responses\n- [`modern-errors-winston`](https://github.com/ehmicky/modern-errors-winston):\n  Log errors with Winston\n- [`modern-errors-switch`](https://github.com/ehmicky/modern-errors-switch):\n  Execute class-specific logic\n\n# Support\n\nFor any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).\n\nEveryone is welcome regardless of personal background. We enforce a\n[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and\ninclusive environment.\n\n# Contributing\n\nThis project was made with ❤️. The simplest way to give back is by starring and\nsharing it online.\n\nIf the documentation is unclear or has a typo, please click on the page's `Edit`\nbutton (pencil icon) and suggest a correction.\n\nIf you would like to help us fix a bug or add a new feature, please check our\n[guidelines](CONTRIBUTING.md). Pull requests are welcome!\n\n\u003c!-- Thanks go to our wonderful contributors: --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START --\u003e\n\u003c!-- prettier-ignore --\u003e\n\u003c!--\n\u003ctable\u003e\u003ctr\u003e\u003ctd align=\"center\"\u003e\u003ca href=\"https://fosstodon.org/@ehmicky\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/8136211?v=4\" width=\"100px;\" alt=\"ehmicky\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eehmicky\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/modern-errors-beautiful/commits?author=ehmicky\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#design-ehmicky\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"#ideas-ehmicky\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/ehmicky/modern-errors-beautiful/commits?author=ehmicky\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e\n --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fmodern-errors-beautiful","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehmicky%2Fmodern-errors-beautiful","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fmodern-errors-beautiful/lists"}