Console 接口文档

本文档提供了 Console 类的 JavaScript 接口。该类用于消息解析脚本日志打印，支持处理各种类型的参数，并将日志消息存储到列表中，供后续格式化输出。

类描述

Console 是一个日志打印工具，支持 debug、warn、error、info 和 log 五种日志级别，能够处理多种类型的输入参数（包括对象、错误对象和空值），并将日志消息存储到提供的列表中。日志消息支持 JSON 序列化，添加时间戳和日志级别。

方法

debug(...messages)

记录调试级别的日志消息。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入（对象、字符串、错误对象等）。

行为

• 将消息格式化为字符串并以 DEBUG: 前缀添加到 loggedMessages 数组。

示例

console.debug("Test message", { key: "value" }, null);
// loggedMessages 包含: "DEBUG: \"Test message\" {\"key\":\"value\"} null"

trace(...messages)

记录追踪级别的日志消息（用于函数调用栈追踪或详细执行路径）。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入（对象、字符串、错误对象等）。

行为

• 将消息格式化为字符串并以 TRACE: 前缀添加到 loggedMessages 数组。
• 在后续格式化输出时，日志级别显示为 TRACE。

示例

consoleJS.trace("Entering function processData", { input: data });
// loggedMessages 包含: "TRACE: \"Entering function processData\" {\"input\":...}"

warn(...messages)

记录警告级别的日志消息。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入。

行为

• 将消息格式化为字符串并以 WARN: 前缀添加到 loggedMessages 数组。

示例

console.warn("Warning occurred", { code: 404 });
// loggedMessages 包含: "WARN: \"Warning occurred\" {\"code\":404}"

error(...messages)

记录错误级别的日志消息。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入。

行为

• 将消息格式化为字符串并以 ERROR: 前缀添加到 loggedMessages 数组。
• 如果参数是错误对象（Error），会包含错误消息和堆栈跟踪。

示例

console.error("Something went wrong");
// loggedMessages 包含: "ERROR: Something went wrong\n\tat ..."

info(...messages)

记录信息级别的日志消息。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入。

行为

• 将消息格式化为字符串并以 INFO: 前缀添加到 loggedMessages 数组。

示例

console.info("Operation successful", { status: "OK" });
// loggedMessages 包含: "INFO: \"Operation successful\" {\"status\":\"OK\"}"

log(...messages)

记录默认级别的日志消息。

参数

• ...messages (any[]): 可变参数，支持任意类型的输入。

行为

• 将消息格式化为字符串（无前缀）添加到 loggedMessages 数组。

示例

console.log("General log", 123);
// loggedMessages 包含: "\"General log\" 123"

注意事项

• 消息处理：
• 如果参数为 null，记录为字符串 "null"。
• 如果参数是错误对象（Error），记录错误消息和完整堆栈跟踪。
• 其他类型的参数尝试使用 JSON 序列化，若失败则直接使用 toString()。
• 所有消息以空格分隔并去除末尾空格。