@apollosoftwarexyz/cinnamon-youch
v3.2.0
Published
A fork of the Youch pretty error reporting library for Cinnamon
Downloads
7
Maintainers
Readme
Youch!
Pretty error reporting for Node.js :rocket:
Youch is inspired by Whoops but with a modern design. Reading stack trace of the console slows you down from active development. Instead Youch print those errors in structured HTML to the browser.
Features
- HTML reporter
- JSON reporter, if request accepts a json instead of text/html.
- Sorted frames of error stack.
- Support for ESM.
Checkout youch terminal to beautify errors on terminal.
Installation
npm i --save youch
Basic Usage
Youch is used by AdonisJs, but it can be used by express or raw HTTP server as well.
const Youch = require('youch')
const http = require('http')
http.createServer(async function (req, res) {
// PERFORM SOME ACTION
if (error) {
const youch = new Youch(error, req)
const html = await youch.toHTML()
res.writeHead(200, {'content-type': 'text/html'})
res.write(html)
res.end()
}
}).listen(8000)
Adding helpful links
Everytime an error occurs, we can help users we letting search for the error on Google, over even on the Github repo of our project.
Youch let you define clickable links to redirect the user to a website with the error message.
const youch = new Youch(error)
await youch
.addLink(({ message }) => {
const url = `https://stackoverflow.com/search?q=${encodeURIComponent(`[adonis.js] ${message}`)}`
return `<a href="${url}" target="_blank" title="Search on stackoverflow">Search stackoverflow</a>`
})
.toHTML()
Also you can make use of Font awesome brands icons to display icons.
If you will use fontawesome icons, then Youch will automatically load the CSS files from the font awesome CDN for you.
const youch = new Youch(error)
await youch
.addLink(({ message }) => {
const url = `https://stackoverflow.com/search?q=${encodeURIComponent(`[adonis.js] ${message}`)}`
return `<a href="${url}" target="_blank" title="Search on stackoverflow"><i class="fab fa-stack-overflow"></i></a>`
})
.toHTML()
Toggle show all frames checkbox
When rendering HTML you can call the toggleShowAllFrames
method to check/uncheck the show all frames checkbox.
By default, the checkbox is not checked and calling this method once will toggle the state.
const youch = new Youch(error)
await youch
.toggleShowAllFrames()
.toHTML()
Get stack as JSON
You can also the error stack frames as JSON by calling the .toJSON
method.
const youch = new Youch(error, {})
const jsonResponse = await youch.toJSON()
Following is the shape of the toJSON
return data type.
type JsonResponse = {
error: {
message: string;
name: string;
status: number;
frames: {
file: string,
filePath: string,
line: number,
column: number,
callee: string,
calleeShort: string,
context: {
start: number,
pre: string,
line: string,
post: string,
},
isModule: boolean,
isNative: boolean,
isApp: boolean
}[];
};
}
Release History
Checkout CHANGELOG.md file for release history.
Meta
Checkout LICENSE.md for license information Harminder Virk (Aman) - https://github.com/thetutlage