console
将脚本中的数据、状态和诊断信息写入仪表日志,用于定位代码与读数问题。
输出与查看日志
log、info、warn、error、debug 接收一个或多个值,按对应级别写入同一日志系统。编辑器预览时可点击右上角 日志 查看;主仪表盘的自定义仪表菜单提供 DEBUG 日志入口。
例如记录一个缺测参数时,应同时输出参数标识符、原值和相关状态,才能知道问题发生在输入还是后续计算。日志输出取决于相应日志捕获是否开启。
示例:检查速度读数
在仪表设置中选择速度,再在需要排查的代码位置输出读数和计算结果。连续绘制会反复执行 main(),定位问题后应移除高频输出。
function main() {
const speed = $data.current.speed;
console.log('speed', speed);
if (speed?.value == null) console.warn('Speed unavailable');
return <Text>{speed?.value == null ? '—' : speed.value}</Text>;
}
日志级别与运行错误
console.error() 只写一条 error 级别日志,本身不会抛异常或停止绘制。运行错误会由运行时另行报告。对象日志按可读形式展开,并限制单条输出长度,因此不适合用于导出完整数据。
优先输出必要的字段,避免每一帧打印整个历史窗口。过多日志会增加开销,也会让真正的错误难以查找。
方法
log(...values: unknown[])void输出普通日志消息
info(...values: unknown[])void输出信息级别日志消息
warn(...values: unknown[])void输出警告级别日志消息
error(...values: unknown[])void输出错误级别日志消息
debug(...values: unknown[])void输出调试级别日志消息