Files
flypic/frontend/src/utils/logger.js
T

187 lines
4.1 KiB
JavaScript

/**
* 牛图(FlyPic)前端日志系统
* 专注于用户操作和UI交互日志
*
* 日志分类:
* - USER: 用户操作(点击、选择、快捷键)
* - FILE: 文件操作(复制、移动、删除、重命名)
* - DATA: 数据加载(加载图片、文件夹、搜索)
* - UI: UI状态(主题切换、面板展开)
* - ERROR: 错误(API失败、操作异常)
*/
const isDev = import.meta.env.DEV;
const isDebugEnabled = isDev || import.meta.env.VITE_ENABLE_DEBUG === 'true';
// 日志类别配置
const LOG_CATEGORIES = {
USER: { emoji: '👤', color: '#3b82f6', label: 'USER' }, // 用户操作
FILE: { emoji: '📁', color: '#10b981', label: 'FILE' }, // 文件操作
DATA: { emoji: '📊', color: '#8b5cf6', label: 'DATA' }, // 数据加载
UI: { emoji: '🎨', color: '#f59e0b', label: 'UI' }, // UI状态
ERROR: { emoji: '❌', color: '#ef4444', label: 'ERROR' }, // 错误
};
/**
* 日志工具类
*/
class Logger {
constructor(namespace = '') {
this.namespace = namespace;
}
/**
* 格式化日志前缀
*/
_getPrefix(category) {
const config = LOG_CATEGORIES[category] || {};
const emoji = config.emoji || '📝';
const label = config.label || 'LOG';
const ns = this.namespace ? `[${this.namespace}]` : '';
return `${emoji} ${label}${ns}`;
}
/**
* 输出彩色日志
*/
_log(category, method, ...args) {
if (!isDebugEnabled && category !== 'ERROR') return;
const config = LOG_CATEGORIES[category];
const prefix = this._getPrefix(category);
if (config && config.color) {
console[method](
`%c${prefix}`,
`color: ${config.color}; font-weight: bold;`,
...args
);
} else {
console[method](prefix, ...args);
}
}
// ==================== 用户操作日志 ====================
/**
* 用户操作日志
* @example logger.user('点击图片', imageId)
*/
user(...args) {
this._log('USER', 'log', ...args);
}
// ==================== 文件操作日志 ====================
/**
* 文件操作日志
* @example logger.file('删除文件', { count: 3, folder: '/photos' })
*/
file(...args) {
this._log('FILE', 'log', ...args);
}
// ==================== 数据加载日志 ====================
/**
* 数据加载日志
* @example logger.data('加载图片', { count: 100, time: 500 })
*/
data(...args) {
this._log('DATA', 'log', ...args);
}
// ==================== UI状态日志 ====================
/**
* UI状态日志
* @example logger.ui('切换主题', 'dark')
*/
ui(...args) {
this._log('UI', 'log', ...args);
}
// ==================== 错误日志 ====================
/**
* 错误日志(所有环境)
* @example logger.error('API请求失败', error)
*/
error(...args) {
this._log('ERROR', 'error', ...args);
}
/**
* 警告日志(所有环境)
*/
warn(...args) {
if (!isDebugEnabled) return;
console.warn(this._getPrefix(''), ...args);
}
// ==================== 调试工具 ====================
/**
* 表格输出(仅开发环境)
*/
table(data) {
if (isDebugEnabled) {
console.table(data);
}
}
/**
* 分组日志(仅开发环境)
*/
group(label, collapsed = false) {
if (isDebugEnabled) {
if (collapsed) {
console.groupCollapsed(label);
} else {
console.group(label);
}
}
}
groupEnd() {
if (isDebugEnabled) {
console.groupEnd();
}
}
/**
* 性能计时
*/
time(label) {
if (isDebugEnabled) {
console.time(label);
}
}
timeEnd(label) {
if (isDebugEnabled) {
console.timeEnd(label);
}
}
}
/**
* 创建带命名空间的日志器
* @param {string} namespace - 日志命名空间
* @returns {Logger} 日志器实例
*
* @example
* const logger = createLogger('ImageWaterfall')
* logger.user('选中图片', imageId)
*/
export function createLogger(namespace) {
return new Logger(namespace);
}
/**
* 默认日志器
*/
export const logger = new Logger();
export default logger;