2 var levels = require("./levels");
3 var DEFAULT_FORMAT = ':remote-addr - -' +
4 ' ":method :url HTTP/:http-version"' +
5 ' :status :content-length ":referrer"' +
8 * Log requests with the given `options` or a `format` string.
12 * - `format` Format string, see below for tokens
13 * - `level` A log4js levels instance. Supports also 'auto'
17 * - `:req[header]` ex: `:req[Accept]`
18 * - `:res[header]` ex: `:res[Content-Length]`
29 * @param {String|Function|Object} format or options
34 function getLogger(logger4js, options) {
35 if ('object' == typeof options) {
36 options = options || {};
38 options = { format: options };
43 var thislogger = logger4js
44 , level = levels.toLevel(options.level, levels.INFO)
45 , fmt = options.format || DEFAULT_FORMAT
46 , nolog = options.nolog ? createNoLogCondition(options.nolog) : null;
48 return function (req, res, next) {
50 if (req._logging) return next();
53 if (nolog && nolog.test(req.originalUrl)) return next();
54 if (thislogger.isLevelEnabled(level) || options.level === 'auto') {
56 var start = new Date()
58 , writeHead = res.writeHead
59 , url = req.originalUrl;
64 // proxy for statusCode.
65 res.writeHead = function(code, headers){
66 res.writeHead = writeHead;
67 res.writeHead(code, headers);
68 res.__statusCode = statusCode = code;
69 res.__headers = headers || {};
71 //status code response level handling
72 if(options.level === 'auto'){
74 if(code >= 300) level = levels.WARN;
75 if(code >= 400) level = levels.ERROR;
77 level = levels.toLevel(options.level, levels.INFO);
81 //hook on end request to emit the log entry of the HTTP request.
82 res.on('finish', function() {
83 res.responseTime = new Date() - start;
84 //status code response level handling
85 if(res.statusCode && options.level === 'auto'){
87 if(res.statusCode >= 300) level = levels.WARN;
88 if(res.statusCode >= 400) level = levels.ERROR;
90 if (thislogger.isLevelEnabled(level)) {
91 var combined_tokens = assemble_tokens(req, res, options.tokens || []);
92 if (typeof fmt === 'function') {
93 var line = fmt(req, res, function(str){ return format(str, combined_tokens); });
94 if (line) thislogger.log(level, line);
96 thislogger.log(level, format(fmt, combined_tokens));
102 //ensure next gets always called
108 * Adds custom {token, replacement} objects to defaults,
109 * overwriting the defaults if any tokens clash
111 * @param {IncomingMessage} req
112 * @param {ServerResponse} res
113 * @param {Array} custom_tokens
114 * [{ token: string-or-regexp, replacement: string-or-replace-function }]
117 function assemble_tokens(req, res, custom_tokens) {
118 var array_unique_tokens = function(array) {
119 var a = array.concat();
120 for(var i=0; i<a.length; ++i) {
121 for(var j=i+1; j<a.length; ++j) {
122 if(a[i].token == a[j].token) { // not === because token can be regexp object
130 var default_tokens = [];
131 default_tokens.push({ token: ':url', replacement: getUrl(req) });
132 default_tokens.push({ token: ':protocol', replacement: req.protocol });
133 default_tokens.push({ token: ':hostname', replacement: req.hostname });
134 default_tokens.push({ token: ':method', replacement: req.method });
135 default_tokens.push({ token: ':status', replacement: res.__statusCode || res.statusCode });
136 default_tokens.push({ token: ':response-time', replacement: res.responseTime });
137 default_tokens.push({ token: ':date', replacement: new Date().toUTCString() });
138 default_tokens.push({
140 replacement: req.headers.referer || req.headers.referrer || ''
142 default_tokens.push({
143 token: ':http-version',
144 replacement: req.httpVersionMajor + '.' + req.httpVersionMinor
146 default_tokens.push({
147 token: ':remote-addr',
149 req.headers['x-forwarded-for'] ||
151 req._remoteAddress ||
153 (req.socket.remoteAddress ||
154 (req.socket.socket && req.socket.socket.remoteAddress)
159 default_tokens.push({ token: ':user-agent', replacement: req.headers['user-agent'] });
160 default_tokens.push({
161 token: ':content-length',
163 (res._headers && res._headers['content-length']) ||
164 (res.__headers && res.__headers['Content-Length']) ||
168 default_tokens.push({ token: /:req\[([^\]]+)\]/g, replacement: function(_, field) {
169 return req.headers[field.toLowerCase()];
171 default_tokens.push({ token: /:res\[([^\]]+)\]/g, replacement: function(_, field) {
172 return res._headers ?
173 (res._headers[field.toLowerCase()] || res.__headers[field])
174 : (res.__headers && res.__headers[field]);
177 return array_unique_tokens(custom_tokens.concat(default_tokens));
181 * Return request url path,
182 * adding this function prevents the Cyclomatic Complexity,
183 * for the assemble_tokens function at low, to pass the tests.
185 * @param {IncomingMessage} req
190 function getUrl(req){
191 return req.originalUrl || req.url;
194 * Return formatted log line.
196 * @param {String} str
197 * @param {IncomingMessage} req
198 * @param {ServerResponse} res
203 function format(str, tokens) {
204 for (var i = 0; i < tokens.length; i++) {
205 str = str.replace(tokens[i].token, tokens[i].replacement);
211 * Return RegExp Object about nolog
213 * @param {String} nolog
220 * NOT LOGGING http://example.com/hoge.gif and http://example.com/hoge.gif?fuga
221 * LOGGING http://example.com/hoge.agif
222 * 1.2 in "\\.gif|\\.jpg$"
223 * NOT LOGGING http://example.com/hoge.gif and
224 * http://example.com/hoge.gif?fuga and http://example.com/hoge.jpg?fuga
225 * LOGGING http://example.com/hoge.agif,
226 * http://example.com/hoge.ajpg and http://example.com/hoge.jpg?hoge
227 * 1.3 in "\\.(gif|jpe?g|png)$"
228 * NOT LOGGING http://example.com/hoge.gif and http://example.com/hoge.jpeg
229 * LOGGING http://example.com/hoge.gif?uid=2 and http://example.com/hoge.jpg?pid=3
231 * 2.1 in /\.(gif|jpe?g|png)$/
234 * 3.1 ["\\.jpg$", "\\.png", "\\.gif"]
235 * SAME AS "\\.jpg|\\.png|\\.gif"
237 function createNoLogCondition(nolog) {
241 if (nolog instanceof RegExp) {
245 if (typeof nolog === 'string') {
246 regexp = new RegExp(nolog);
249 if (Array.isArray(nolog)) {
250 var regexpsAsStrings = nolog.map(
251 function convertToStrings(o) {
252 return o.source ? o.source : o;
255 regexp = new RegExp(regexpsAsStrings.join('|'));
262 exports.connectLogger = getLogger;