@nine-lab/nine-util

실시간 협업, 판서 및 효율적인 디버깅을 위한 유틸리티 라이브러리입니다.

설치

npm install @nine-lab/nine-util

사용법

1. 실시간 로그 추적 (Trace) 단순한 console.log 대신 서비스별로 색상과 이름표를 붙여 가독성 높은 로그를 남길 수 있습니다.

   import { trace } from '@nine-lab/nine-util';

   // 1. 초기화 (이름과 색상 설정) trace.init("NineBoard", "#4CAF50");

   // 2. 사용 trace.log("서버 연결 시도..."); trace.warn("연결 지연 발생"); trace.error("연결 실패", err);

   // 배포 시 로그 끄기 if (import.meta.env.PROD) trace.disable();

2. 작업 최적화 (TaskDebouncer) 비동기 작업이나 잦은 이벤트 발생 시 중복 실행을 방지하고 순차적으로 처리합니다.

   import { trace } from '@nine-lab/nine-util';

   // 1. 초기화 (이름과 색상 설정) trace.init("NineBoard", "#4CAF50");

   // 2. 사용 trace.log("서버 연결 시도..."); trace.warn("연결 지연 발생"); trace.error("연결 실패", err);

   // 배포 시 로그 끄기 if (import.meta.env.PROD) trace.disable();

API Reference

1. Trace trace.init(name, color): 로거의 헤더 이름과 테마 색상을 설정합니다. trace.enable() / trace.disable(): 로그 출력 여부를 제어합니다. trace.log() / .warn() / .error(): 스타일이 적용된 로그를 출력합니다.

2. TaskDebouncer new TaskDebouncer(delay): 대기 시간을 설정하여 인스턴스를 생성합니다. execute(task): 설정된 딜레이 이후 작업을 수행하며 중복 실행을 방지합니다.