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輸出偵錯層級日誌訊息