{"id":15117123,"url":"https://github.com/ehmicky/modern-errors-winston","last_synced_at":"2025-03-19T08:30:46.943Z","repository":{"id":62750900,"uuid":"561926654","full_name":"ehmicky/modern-errors-winston","owner":"ehmicky","description":"`modern-errors` plugin for Winston.","archived":false,"fork":false,"pushed_at":"2025-03-17T02:46:08.000Z","size":5751,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-17T03:30:54.289Z","etag":null,"topics":["browser","console","error","error-handler","error-handling","error-monitoring","http","javascript","library","logger","logger-middleware","logging","modern-errors","modern-errors-plugin","nodejs","plugins","typescript","winston","winston-logger","winstonjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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}},"created_at":"2022-11-04T20:17:45.000Z","updated_at":"2025-03-17T02:46:12.000Z","dependencies_parsed_at":"2023-02-18T19:01:05.586Z","dependency_job_id":"2d6947f9-1b65-4a06-8d54-13db7283604d","html_url":"https://github.com/ehmicky/modern-errors-winston","commit_stats":{"total_commits":212,"total_committers":3,"mean_commits":70.66666666666667,"dds":0.02358490566037741,"last_synced_commit":"e1e949db9880a5474a32b15223e8408310cc2141"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":"ehmicky/template-javascript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-winston","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-winston/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-winston/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fmodern-errors-winston/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehmicky","download_url":"https://codeload.github.com/ehmicky/modern-errors-winston/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244389704,"owners_count":20444989,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["browser","console","error","error-handler","error-handling","error-monitoring","http","javascript","library","logger","logger-middleware","logging","modern-errors","modern-errors-plugin","nodejs","plugins","typescript","winston","winston-logger","winstonjs"],"created_at":"2024-09-26T01:45:50.710Z","updated_at":"2025-03-19T08:30:46.929Z","avatar_url":"https://github.com/ehmicky.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"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-winston)\n[![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript\u0026colorA=404040\u0026logoColor=0096ff)](/src/main.d.ts)\n[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov\u0026colorA=404040)](https://codecov.io/gh/ehmicky/modern-errors-winston)\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) for\n[Winston](https://github.com/winstonjs/winston).\n\nThis adds [`BaseError.fullFormat()`](#baseerrorfullformat) and\n[`BaseError.shortFormat()`](#baseerrorshortformat) which return a\n[Winston format](https://github.com/winstonjs/winston/blob/master/README.md#formats).\n\n# Hire me\n\nPlease\n[reach out](https://www.linkedin.com/feed/update/urn:li:activity:7117265228068716545/)\nif you're looking for a Node.js API or CLI engineer (11 years of experience).\nMost recently I have been [Netlify Build](https://github.com/netlify/build)'s\nand [Netlify Plugins](https://www.netlify.com/products/build/plugins/)'\ntechnical lead for 2.5 years. I am available for full-time remote positions.\n\n# Features\n\nImproved error logging with Winston:\n\n- Error [class/instance-specific](#configuration) log [level](#level) or\n  [verbosity](#stack)\n- The [full format](#baseerrorfullformat) includes all properties\n- The [short format](#baseerrorshortformat) includes only the error's `name`,\n  `message` and `stack`\n- Works with\n  [uncaught exceptions](https://github.com/winstonjs/winston#exceptions)\n\nUnlike Winston's default\n[error format](https://github.com/winstonjs/logform#errors):\n\n- The error `name` is logged\n- The full format logs nested errors, including\n  [`cause`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error/cause)\n  and aggregate\n  [`errors`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AggregateError)\n- The full format is [JSON-safe](https://github.com/ehmicky/safe-json-value)\n- The short format optionally logs the stack trace\n- The error instance is not modified\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 modernErrorsWinston from 'modern-errors-winston'\n\nexport const BaseError = ModernError.subclass('BaseError', {\n  plugins: [modernErrorsWinston],\n})\nexport const InputError = BaseError.subclass('InputError')\n// ...\n```\n\nUsing the [full format](#baseerrorfullformat) with Winston.\n\n```js\nimport { createLogger, format, transports } from 'winston'\n\nconst logger = createLogger({\n  format: format.combine(BaseError.fullFormat(), format.json()),\n  transports: [new transports.Http(httpOptions)],\n})\n\nconst error = new InputError('Could not read file.', { props: { filePath } })\nlogger.error(error)\n// Sent via HTTP:\n// {\n//   level: 'error',\n//   name: 'InputError',\n//   message: 'Could not read file.',\n//   stack: `InputError: Could not read file.\n//     at ...`,\n//   filePath: '/...',\n// }\n```\n\nUsing the [short format](#baseerrorshortformat) with Winston.\n\n```js\nimport { createLogger, format, transports } from 'winston'\n\nconst logger = createLogger({\n  format: format.combine(BaseError.shortFormat(), format.cli()),\n  transports: [new transports.Console()],\n})\n\nconst error = new InputError('Could not read file.', { props: { filePath } })\nlogger.error(error)\n// Printed on the console:\n// error: InputError: Could not read file.\n//     at ...\n```\n\n# Install\n\n```bash\nnpm install modern-errors-winston\n```\n\nThis package requires installing [Winston](https://github.com/winstonjs/winston)\nseparately.\n\n```bash\nnpm install winston\n```\n\nThis package works in 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## modernErrorsWinston\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.fullFormat()\n\n_Return value_: `Format`\n\nReturns a logger\n[`format`](https://github.com/winstonjs/winston/blob/master/README.md#formats)\nto [combine](https://github.com/winstonjs/winston#combining-formats) with\n[`format.json()`](https://github.com/winstonjs/logform#json) or\n[`format.prettyPrint()`](https://github.com/winstonjs/logform#prettyprint). This\nlogs all error properties, making it useful with\n[transports](https://github.com/winstonjs/winston#transports) like\n[HTTP](https://github.com/winstonjs/winston/blob/master/docs/transports.md#http-transport).\n\nErrors should be logged using\n[`logger.*(error)`](https://github.com/winstonjs/winston/blob/master/README.md#creating-your-own-logger).\n\n## BaseError.shortFormat()\n\n_Return value_: `Format`\n\nReturns a logger\n[`format`](https://github.com/winstonjs/winston/blob/master/README.md#formats)\nto [combine](https://github.com/winstonjs/winston#combining-formats) with\n[`format.simple()`](https://github.com/winstonjs/logform#simple) or\n[`format.cli()`](https://github.com/winstonjs/logform#cli). This logs only the\nerror `name`, `message` and `stack`, making it useful with\n[transports](https://github.com/winstonjs/winston#transports) like the\n[console](https://github.com/winstonjs/winston/blob/master/docs/transports.md#console-transport).\n\nErrors should be logged using\n[`logger.*(error)`](https://github.com/winstonjs/winston/blob/master/README.md#creating-your-own-logger).\n\n## Options\n\n_Type_: `object`\n\n### stack\n\n_Type_: `boolean`\\\n_Default_: `true`\n\nWhether to log the stack trace.\n\n### level\n\n_Type_: `string`\n\nOverride the log [level](https://github.com/winstonjs/winston#logging-levels).\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: [modernErrorsWinston],\n  winston: 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', { winston: options })\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('...', { winston: options })\n```\n\n- A specific [`BaseError.fullFormat()`](#baseerrorfullformat) or\n  [`BaseError.shortFormat()`](#baseerrorshortformat) call\n\n```js\nBaseError.fullFormat(options)\n```\n\n# Related projects\n\n- [`winston`](https://github.com/winstonjs/winston): A logger for just about\n  everything\n- [`modern-errors`](https://github.com/ehmicky/modern-errors): Handle errors in\n  a simple, stable, consistent way\n- [`winston-error-format`](https://github.com/ehmicky/winston-error-format): Log\n  errors with Winston\n- [`error-serializer`](https://github.com/ehmicky/error-serializer): Convert\n  errors to/from plain objects\n- [`modern-errors-cli`](https://github.com/ehmicky/modern-errors-cli): Handle\n  errors in CLI modules\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-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-winston/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-winston/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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fmodern-errors-winston","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehmicky%2Fmodern-errors-winston","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fmodern-errors-winston/lists"}