/* MIT License http://www.opensource.org/licenses/mit-license.php Author Tobias Koppers @sokra */ "use strict"; const LogType = Object.freeze({ error: /** @type {"error"} */ ("error"), // message, c style arguments warn: /** @type {"warn"} */ ("warn"), // message, c style arguments info: /** @type {"info"} */ ("info"), // message, c style arguments log: /** @type {"log"} */ ("log"), // message, c style arguments debug: /** @type {"debug"} */ ("debug"), // message, c style arguments trace: /** @type {"trace"} */ ("trace"), // no arguments group: /** @type {"group"} */ ("group"), // [label] groupCollapsed: /** @type {"groupCollapsed"} */ ("groupCollapsed"), // [label] groupEnd: /** @type {"groupEnd"} */ ("groupEnd"), // [label] profile: /** @type {"profile"} */ ("profile"), // [profileName] profileEnd: /** @type {"profileEnd"} */ ("profileEnd"), // [profileName] time: /** @type {"time"} */ ("time"), // name, time as [seconds, nanoseconds] clear: /** @type {"clear"} */ ("clear"), // no arguments status: /** @type {"status"} */ ("status") // message, arguments }); module.exports.LogType = LogType; /** @typedef {typeof LogType[keyof typeof LogType]} LogTypeEnum */ const LOG_SYMBOL = Symbol("webpack logger raw log method"); const TIMERS_SYMBOL = Symbol("webpack logger times"); const TIMERS_AGGREGATES_SYMBOL = Symbol("webpack logger aggregated times"); class WebpackLogger { /** * @param {function(LogTypeEnum, any[]=): void} log log function * @param {function(string | function(): string): WebpackLogger} getChildLogger function to create child logger */ constructor(log, getChildLogger) { this[LOG_SYMBOL] = log; this.getChildLogger = getChildLogger; } /** * @param {...any} args args */ error(...args) { this[LOG_SYMBOL](LogType.error, args); } /** * @param {...any} args args */ warn(...args) { this[LOG_SYMBOL](LogType.warn, args); } /** * @param {...any} args args */ info(...args) { this[LOG_SYMBOL](LogType.info, args); } /** * @param {...any} args args */ log(...args) { this[LOG_SYMBOL](LogType.log, args); } /** * @param {...any} args args */ debug(...args) { this[LOG_SYMBOL](LogType.debug, args); } /** * @param {any} assertion assertion * @param {...any} args args */ assert(assertion, ...args) { if (!assertion) { this[LOG_SYMBOL](LogType.error, args); } } trace() { this[LOG_SYMBOL](LogType.trace, ["Trace"]); } clear() { this[LOG_SYMBOL](LogType.clear); } /** * @param {...any} args args */ status(...args) { this[LOG_SYMBOL](LogType.status, args); } /** * @param {...any} args args */ group(...args) { this[LOG_SYMBOL](LogType.group, args); } /** * @param {...any} args args */ groupCollapsed(...args) { this[LOG_SYMBOL](LogType.groupCollapsed, args); } groupEnd() { this[LOG_SYMBOL](LogType.groupEnd); } /** * @param {string=} label label */ profile(label) { this[LOG_SYMBOL](LogType.profile, [label]); } /** * @param {string=} label label */ profileEnd(label) { this[LOG_SYMBOL](LogType.profileEnd, [label]); } /** * @param {string} label label */ time(label) { /** @type {Map} */ this[TIMERS_SYMBOL] = this[TIMERS_SYMBOL] || new Map(); this[TIMERS_SYMBOL].set(label, process.hrtime()); } /** * @param {string=} label label */ timeLog(label) { const prev = this[TIMERS_SYMBOL] && this[TIMERS_SYMBOL].get(label); if (!prev) { throw new Error(`No such label '${label}' for WebpackLogger.timeLog()`); } const time = process.hrtime(prev); this[LOG_SYMBOL](LogType.time, [label, ...time]); } /** * @param {string=} label label */ timeEnd(label) { const prev = this[TIMERS_SYMBOL] && this[TIMERS_SYMBOL].get(label); if (!prev) { throw new Error(`No such label '${label}' for WebpackLogger.timeEnd()`); } const time = process.hrtime(prev); /** @type {Map} */ (this[TIMERS_SYMBOL]).delete(label); this[LOG_SYMBOL](LogType.time, [label, ...time]); } /** * @param {string=} label label */ timeAggregate(label) { const prev = this[TIMERS_SYMBOL] && this[TIMERS_SYMBOL].get(label); if (!prev) { throw new Error( `No such label '${label}' for WebpackLogger.timeAggregate()` ); } const time = process.hrtime(prev); /** @type {Map} */ (this[TIMERS_SYMBOL]).delete(label); /** @type {Map} */ this[TIMERS_AGGREGATES_SYMBOL] = this[TIMERS_AGGREGATES_SYMBOL] || new Map(); const current = this[TIMERS_AGGREGATES_SYMBOL].get(label); if (current !== undefined) { if (time[1] + current[1] > 1e9) { time[0] += current[0] + 1; time[1] = time[1] - 1e9 + current[1]; } else { time[0] += current[0]; time[1] += current[1]; } } this[TIMERS_AGGREGATES_SYMBOL].set(label, time); } /** * @param {string=} label label */ timeAggregateEnd(label) { if (this[TIMERS_AGGREGATES_SYMBOL] === undefined) return; const time = this[TIMERS_AGGREGATES_SYMBOL].get(label); if (time === undefined) return; this[TIMERS_AGGREGATES_SYMBOL].delete(label); this[LOG_SYMBOL](LogType.time, [label, ...time]); } } module.exports.Logger = WebpackLogger;