JS日志記錄級別設置指南

在JavaScript中，日志記錄是調試和監控應用程序的重要手段。設置日志級別可以幫助你控制輸出的信息量，從而提高應用程序的性能和可維護性。以下是關于JS日志記錄級別設置的指南：

使用console對象進行日志記錄

Node.js內置的console對象提供了不同級別的日志方法，包括console.log()、console.info()、console.warn()和console.error()。雖然這些方法沒有內置的日志級別設置，但你可以通過自定義函數來模擬日志級別的功能。

// 定義日志級別
const LogLevel = { OFF: 0, ERROR: 1, WARN: 2, INFO: 3, DEBUG: 4 };
// 設置當前日志級別
let currentLogLevel = LogLevel.INFO;

// 自定義日志函數
function log(level, message) {
  if (level <= currentLogLevel) {
    console[level](message);
  }
}

// 使用自定義日志函數
log(LogLevel.DEBUG, '這是一條調試信息'); // 不會顯示，因為當前級別是INFO
log(LogLevel.INFO, '這是一條普通信息'); // 會顯示
log(LogLevel.WARN, '這是一條警告信息'); // 會顯示
log(LogLevel.ERROR, '這是一條錯誤信息'); // 會顯示

使用第三方日志庫

許多JavaScript應用程序使用第三方日志庫來管理日志級別和輸出。以下是一些流行的日志庫及其配置方法：

Winston

Winston是一個非常流行的Node.js日志庫，支持多種傳輸方式和日志級別。

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info', // 設置默認日志級別
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' }),
  ],
});

logger.info('This is an info message');
logger.error('This is an error message');

log4js

log4js是另一個流行的結構化日志庫。

const log4js = require('log4js');
log4js.configure({
  appenders: { out: { type: 'stdout' } },
  categories: {
    default: { appenders: ['out'], level: 'info' },
    debug: { appenders: ['out'], level: 'debug' },
  },
});
const logger = log4js.getLogger();

logger.setLevel('debug');
logger.info('This is an info message');
logger.debug('This is a debug message');

Winston和log4js的配置示例

1. Winston配置示例：

const winston = require('winston');
const logger = winston.createLogger({
  level: 'info', // 設置默認日志級別
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' }),
  ],
});

// 通過環境變量設置級別
logger.level = process.env.LOG_LEVEL || 'info';

logger.error('錯誤信息');
logger.warn('警告信息');
logger.info('普通信息');
logger.debug('調試信息');

2. log4js配置示例：

const log4js = require('log4js');
log4js.configure({
  appenders: { out: { type: 'stdout' } },
  categories: {
    default: { appenders: ['out'], level: 'info' },
    debug: { appenders: ['out'], level: 'debug' },
  },
});
const logger = log4js.getLogger();

// 設置特定模塊的日志級別
logger.setLevel('debug');
logger.info('This is an info message');
logger.debug('This is a debug message');

使用環境變量設置日志級別

你還可以通過設置環境變量來控制日志級別。例如，對于Winston庫，你可以使用LOG_LEVEL環境變量：

export LOG_LEVEL=debug
node your-app.js

這將設置日志級別為debug。

總結

設置JavaScript應用程序的日志級別可以通過以下幾種方法實現：

1. 使用Node.js內置的console對象：通過自定義函數來模擬日志級別的行為。
2. 使用第三方日志庫：如Winston、log4js等，這些庫提供了更多的功能和配置選項。
3. 配置環境變量：通過環境變量來動態設置日志級別。
4. 使用配置文件：通過配置文件來設置日志級別，適用于復雜的應用程序。

選擇哪種方法取決于你的具體需求和應用程序的架構。