console

データ、ステータス、診断情報をスクリプトから計測ログに書き込み、コードと読み取りの問題を特定します。

ログの出力と表示

log、info、warn、error、debug は 1 つ以上の値を受け取り、対応するレベルに従って同じログ システムに書き込みます。右上隅の ログ をクリックすると、エディターのプレビューが表示されます。メイン ダッシュボードのカスタム計測器メニューには、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() はエラー レベルのログを書き込むだけで、例外をスローしたり描画を停止したりしません。ランタイム エラーは、ランタイムによって個別に報告されます。オブジェクト ログは読み取り可能な形式で展開され、単一出力の長さに制限があるため、完全なデータのエクスポートには適していません。

フレームごとに履歴ウィンドウ全体を印刷することを避けるために、必要なフィールドの出力を優先します。過剰なロギングによりオーバーヘッドが増加し、実際のエラーを見つけることが困難になります。

方法

log(...values: unknown[])void

一般ログメッセージを出力

info(...values: unknown[])void

情報ログメッセージを出力

warn(...values: unknown[])void

警告ログメッセージを出力

error(...values: unknown[])void

エラーログメッセージを出力

debug(...values: unknown[])void

デバッグログメッセージを出力