/*
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
Author Tobias Koppers @sokra
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
const { LogType } = require("./Logger");
|
|
|
|
/** @typedef {import("./Logger").LogTypeEnum} LogTypeEnum */
|
|
/** @typedef {import("../../declarations/WebpackOptions").FilterTypes} FilterTypes */
|
|
/** @typedef {import("../../declarations/WebpackOptions").FilterItemTypes} FilterItemTypes */
|
|
|
|
/** @typedef {function(string): boolean} FilterFunction */
|
|
|
|
/**
|
|
* @typedef {Object} LoggerOptions
|
|
* @property {false|true|"none"|"error"|"warn"|"info"|"log"|"verbose"} level loglevel
|
|
* @property {FilterTypes|boolean} debug filter for debug logging
|
|
* @property {Console & { status?: Function, logTime?: Function }} console the console to log to
|
|
*/
|
|
|
|
/**
|
|
* @param {FilterItemTypes} item an input item
|
|
* @returns {FilterFunction} filter funtion
|
|
*/
|
|
const filterToFunction = item => {
|
|
if (typeof item === "string") {
|
|
const regExp = new RegExp(
|
|
`[\\\\/]${item.replace(
|
|
// eslint-disable-next-line no-useless-escape
|
|
/[-[\]{}()*+?.\\^$|]/g,
|
|
"\\$&"
|
|
)}([\\\\/]|$|!|\\?)`
|
|
);
|
|
return ident => regExp.test(ident);
|
|
}
|
|
if (item && typeof item === "object" && typeof item.test === "function") {
|
|
return ident => item.test(ident);
|
|
}
|
|
if (typeof item === "function") {
|
|
return item;
|
|
}
|
|
if (typeof item === "boolean") {
|
|
return () => item;
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @enum {number}
|
|
*/
|
|
const LogLevel = {
|
|
none: 6,
|
|
false: 6,
|
|
error: 5,
|
|
warn: 4,
|
|
info: 3,
|
|
log: 2,
|
|
true: 2,
|
|
verbose: 1
|
|
};
|
|
|
|
/**
|
|
* @param {LoggerOptions} options options object
|
|
* @returns {function(string, LogTypeEnum, any[]): void} logging function
|
|
*/
|
|
module.exports = ({ level = "info", debug = false, console }) => {
|
|
const debugFilters =
|
|
typeof debug === "boolean"
|
|
? [() => debug]
|
|
: /** @type {FilterItemTypes[]} */ ([])
|
|
.concat(debug)
|
|
.map(filterToFunction);
|
|
/** @type {number} */
|
|
const loglevel = LogLevel[`${level}`] || 0;
|
|
|
|
/**
|
|
* @param {string} name name of the logger
|
|
* @param {LogTypeEnum} type type of the log entry
|
|
* @param {any[]} args arguments of the log entry
|
|
* @returns {void}
|
|
*/
|
|
const logger = (name, type, args) => {
|
|
const labeledArgs = () => {
|
|
if (Array.isArray(args)) {
|
|
if (args.length > 0 && typeof args[0] === "string") {
|
|
return [`[${name}] ${args[0]}`, ...args.slice(1)];
|
|
} else {
|
|
return [`[${name}]`, ...args];
|
|
}
|
|
} else {
|
|
return [];
|
|
}
|
|
};
|
|
const debug = debugFilters.some(f => f(name));
|
|
switch (type) {
|
|
case LogType.debug:
|
|
if (!debug) return;
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.debug === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.debug(...labeledArgs());
|
|
} else {
|
|
console.log(...labeledArgs());
|
|
}
|
|
break;
|
|
case LogType.log:
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
console.log(...labeledArgs());
|
|
break;
|
|
case LogType.info:
|
|
if (!debug && loglevel > LogLevel.info) return;
|
|
console.info(...labeledArgs());
|
|
break;
|
|
case LogType.warn:
|
|
if (!debug && loglevel > LogLevel.warn) return;
|
|
console.warn(...labeledArgs());
|
|
break;
|
|
case LogType.error:
|
|
if (!debug && loglevel > LogLevel.error) return;
|
|
console.error(...labeledArgs());
|
|
break;
|
|
case LogType.trace:
|
|
if (!debug) return;
|
|
console.trace();
|
|
break;
|
|
case LogType.groupCollapsed:
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
if (!debug && loglevel > LogLevel.verbose) {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.groupCollapsed === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.groupCollapsed(...labeledArgs());
|
|
} else {
|
|
console.log(...labeledArgs());
|
|
}
|
|
break;
|
|
}
|
|
// falls through
|
|
case LogType.group:
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.group === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.group(...labeledArgs());
|
|
} else {
|
|
console.log(...labeledArgs());
|
|
}
|
|
break;
|
|
case LogType.groupEnd:
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.groupEnd === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.groupEnd();
|
|
}
|
|
break;
|
|
case LogType.time: {
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
const ms = args[1] * 1000 + args[2] / 1000000;
|
|
const msg = `[${name}] ${args[0]}: ${ms}ms`;
|
|
if (typeof console.logTime === "function") {
|
|
console.logTime(msg);
|
|
} else {
|
|
console.log(msg);
|
|
}
|
|
break;
|
|
}
|
|
case LogType.profile:
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.profile === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.profile(...labeledArgs());
|
|
}
|
|
break;
|
|
case LogType.profileEnd:
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.profileEnd === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.profileEnd(...labeledArgs());
|
|
}
|
|
break;
|
|
case LogType.clear:
|
|
if (!debug && loglevel > LogLevel.log) return;
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
if (typeof console.clear === "function") {
|
|
// eslint-disable-next-line node/no-unsupported-features/node-builtins
|
|
console.clear();
|
|
}
|
|
break;
|
|
case LogType.status:
|
|
if (!debug && loglevel > LogLevel.info) return;
|
|
if (typeof console.status === "function") {
|
|
if (args.length === 0) {
|
|
console.status();
|
|
} else {
|
|
console.status(...labeledArgs());
|
|
}
|
|
} else {
|
|
if (args.length !== 0) {
|
|
console.info(...labeledArgs());
|
|
}
|
|
}
|
|
break;
|
|
default:
|
|
throw new Error(`Unexpected LogType ${type}`);
|
|
}
|
|
};
|
|
return logger;
|
|
};
|