Security News
Combatting Alert Fatigue by Prioritizing Malicious Intent
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
Express middleware for showing detailed error information when errors happen in your app.
Inspired by phperror.net.
Visit the example error page to see it in action.
npm install errorface
var express = require("express"),
errorface = require("errorface");
var app = express();
app.get("/", function(req, res, next) {
res.send("Hello World");
});
app.get("/error", function(req, res, next) {
app.doesntExist();
});
app.get("/*", function(req, res) {
throw new Error("Not Found");
});
app.use(errorface.errorHandler());
app.listen(3000);
You can extend the middleware with a couple options, here are the defaults:
// Default options
var options = {
// Output to console.log
log: console.log,
// We don't output errors to log unless you want to
logErrors: false,
// We return html response page if requested
disableHtml: false,
// We return json response if requested
disableJson: false,
// Pass a function (or a true/false value) to determine whether the error page should be shown
showPage: function(err, req) {
return true;
},
// We use Mustache to render templates by default
templateFunc: Mustache.render,
// You can pass a string in as a template
errorPageTemplate: null,
// Or, you can pass a path to a file to use as the template
errorPageTemplatePath: __dirname + "/views/errorPage.stache",
// If you want to twiddle with the data before it gets sent to the template
preProcessTemplateData: function(data) { return data; }
};
// Just pass them to the errorHandler when you register with your express app
app.use(errorface.errorHandler(options));
Here is an example of the data that gets sent to the template in case you want to create your own.
{
"headLine":{
"type":"description",
"details":{
"error":"Error",
"message":"Not Found"
}
},
"stack":[
{
"level":1,
"trace":{
"type":"file",
"details":{
"method":"init",
"file":"''/projects/errorface/test/util/testServer.coffee",
"fileHash":"2c57b3f110c76c5348e3e03296430f6b",
"fileRelative":"/test/util/testServer.coffee",
"line":18,
"column":13
}
},
"focused":"throw new Error(\"Not Found\");",
"file":[
{
"num":14,
"isFocus":false,
"line":" app.get(\"/error\", function(req, res, next) {"
}
]
}
],
"lines":[
{
"type":"description",
"details":{
"error":"Error",
"message":"Not Found"
}
},
{
"type":"file",
"details":{
"method":"init",
"file":"''/projects/errorface/test/util/testServer.coffee",
"fileHash":"2c57b3f110c76c5348e3e03296430f6b",
"fileRelative":"/test/util/testServer.coffee",
"line":18,
"column":13
}
},
{
"type":"file",
"details":{
"method":"callbacks",
"file":"''/projects/errorface/node_modules/express/lib/router/index.js",
"fileHash":"ba7d97ee1f59f2aa0920257deb060e46",
"fileRelative":"[module]/express/lib/router/index.js",
"line":162,
"column":11
}
}
],
"projectDirectory":"''/projects/errorface"
}
Copyright 2012 Jacob Gable, MIT License; no attribution required.
FAQs
Shows a styled error page while developing your app.
We found that errorface demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In 2023, data breaches surged 78% from zero-day and supply chain attacks, but developers are still buried under alerts that are unable to prevent these threats.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.