4.1.0 • Published 11 years ago
log-errors v4.1.0
Log Errors
Quickstart
var logErrors = require('log-errors'),
logProd = logErrors.production,
logDev = logErrors.development;
try {
throw new error("funky");
} catch (e) {
logDev(e);
}
This will output in colored text:
Error name: Error
Error object:
{ Error: funky,
message: 'funky',
type: undefined,
stack: Getter/Setter,
arguments: undefined }
Stack trace:
'Error: funky
at Object.<anonymous> (/home/andy/lib/modules/npm/log-errors/lib/development.js:16:12)
at Module._compile (module.js:449:26)
at Object.Module._extensions..js (module.js:467:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:312:12)
at Module.runMain (module.js:492:10)
at process.startup.processNextTick.process._tickCallback (node.js:244:9)'
Using in Express.js
It will also log request url + query info.
var logErrors = require('log-errors'),
logProd = logErrors.production,
logDev = logErrors.development;
// add this at very bottom (below all route handlers)
// it is designed to catch the errors passed by next(err) calls
app.configure('production', function() {
app.use(logProd);
});
app.configure('development', function() {
app.use(logDev);
// equates to:
// app.use(function(err, req, res, next) {
// logDev(err, req, res, next);
// });
});
Example Output:
Error name: Error
Request:
url: someurl
query: ?some=random&query=params
Error object:
{ Error: funky,
message: 'funky',
type: undefined,
stack: Getter/Setter,
arguments: undefined }
Stack trace:
'Error: funky
at Object.<anonymous> (/home/andy/lib/modules/npm/log-errors/lib/development.js:16:12)
at Module._compile (module.js:449:26)
at Object.Module._extensions..js (module.js:467:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:312:12)
at Module.runMain (module.js:492:10)
at process.startup.processNextTick.process._tickCallback (node.js:244:9)'
Docs
Info printed to STDOUT
- error name: (err.name)
- error message (err.message)
- error logLevel (err.logLevel)
- request url (req.url)
- request query (req.query)
Log Levels
- Must be one of the 8 unix log levels used in the Visionmedia Logging Module.
- Defaults to 'info' level if not passed one of the 8 listed.
Development Logger
Always prints full error in colored text.
var logDev = require('log-errors').development;
logDev(new Error('development error msg'));
Production Logger
Will only print error info if error.LogLevel is 3 or below, ie 'error', 'critical', 'alert', 'emergency'.
var logProd = require('log-errors').production,
err = newError('some message about the error');
err.logLevel = 'critical'
logProd(err);
Using in Conjunction with Custom Errors npm Module
- If your errors inherit from the custom errors class then the extra error attrs (logLevel, name, message etc) are already added.
- However, the logger should work fine with the built in base error class too.
var valErr = require('custom-errors').general.ValidationError,
logErrors = require('log-errors'),
logProd = logErrors.production,
logDev = logErrors.development;
try {
throw new valErr("funky");
} catch (e) {
logDev(e);
}
Outputs:
Error name: Validation
Error object:
{ logLevel: 'warn',
message: 'funky',
name: 'Validation',
resCode: 400,
[stack]: [Getter/Setter] }
Stack trace:
'Validation: funky
at Object.<anonymous> (/home/andy/lib/modules/npm/log-errors/lib/development.js:18:12)
at Module._compile (module.js:449:26)
at Object.Module._extensions..js (module.js:467:10)
at Module.load (module.js:356:32)
at Function.Module._load (module.js:312:12)
at Module.runMain (module.js:492:10)
at process.startup.processNextTick.process._tickCallback (node.js:244:9)'
4.1.0
11 years ago
4.0.1
11 years ago
4.0.0
11 years ago
3.4.2
11 years ago
3.4.1
11 years ago
3.4.0
11 years ago
3.3.0
11 years ago
3.2.0
11 years ago
3.1.0
11 years ago
3.0.0
11 years ago
2.0.2
11 years ago
2.0.1
11 years ago
2.0.0
11 years ago
1.1.0
11 years ago
1.0.1
11 years ago
1.0.0
11 years ago
0.1.2
11 years ago
0.1.1
11 years ago