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()은 오류 수준 로그만 기록하고 예외를 발생시키거나 그리기를 중지하지 않습니다. 런타임 오류는 런타임별로 별도로 보고됩니다. 객체 로그는 읽을 수 있는 형식으로 확장되고 단일 출력의 길이를 제한하므로 전체 데이터를 내보내는 데 적합하지 않습니다.

프레임마다 전체 기록 창을 인쇄하지 않도록 필요한 필드의 출력에 우선순위를 둡니다. 과도한 로깅은 오버헤드를 증가시키고 실제 오류를 찾기 어렵게 만듭니다.

방법

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

일반 로그 메시지 출력

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

정보 로그 메시지 출력

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

경고 로그 메시지 출력

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

오류 로그 메시지 출력

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

디버그 로그 메시지 출력