Class LogSystem

LogSystem - Voxel-3D 로그 시스템

라이브러리의 동작을 추적하고 디버깅을 지원합니다.

Remarks

레벨 기반 로그 filters링
카테고리별 log levels config
performance timing (time/timeEnd)
스타일링된 console output
history management

Example

const log = new LogSystem({ level: LogLevel.DEBUG });

log.info('viewer', '뷰어 initialization 완료');
log.debug('importer', '모델 load 시작', { url: 'model.glb' });

// performance timing
log.time('load-model');
await loadModel();
log.timeEnd('load-model'); // "load-model: 1234.56ms"

// 카테고리 로거
const viewerLog = log.createLogger('viewer');
viewerLog.info('initialization 완료');

Implements

ILogSystem

Index

Constructors

constructor

new LogSystem(config?: LogSystemConfig): LogSystem
Parameters
- config: LogSystemConfig = {}
Returns LogSystem
- Defined in systems/log/LogSystem.ts:53

Methods

setLevel

setLevel(level: LogLevel): void
전역 log levels config
Parameters
- level: LogLevel
Returns void
Implementation of ILogSystem.setLevel
- Defined in systems/log/LogSystem.ts:73

getLevel

getLevel(): LogLevel
현재 log levels 조회

Returns LogLevel
Implementation of ILogSystem.getLevel
- Defined in systems/log/LogSystem.ts:80

setCategoryLevel

setCategoryLevel(category: string, level: LogLevel): void
카테고리별 log levels config
Parameters
- category: string
- level: LogLevel
Returns void
Implementation of ILogSystem.setCategoryLevel
- Defined in systems/log/LogSystem.ts:87

getCategoryLevel

getCategoryLevel(category: string): LogLevel
카테고리별 log levels 조회
Parameters
- category: string
Returns LogLevel
Implementation of ILogSystem.getCategoryLevel
- Defined in systems/log/LogSystem.ts:94

isEnabled

isEnabled(level: LogLevel, category?: string): boolean
특정 레벨이 현재 활성화되어 있는지 확인
Parameters
- level: LogLevel
- Optionalcategory: string
Returns boolean
Implementation of ILogSystem.isEnabled
- Defined in systems/log/LogSystem.ts:101

error

error(category: string, message: string, data?: unknown): void
ERROR 레벨 로그
Parameters
- category: string
- message: string
- Optionaldata: unknown
Returns void
Implementation of ILogSystem.error
- Defined in systems/log/LogSystem.ts:111

warn

warn(category: string, message: string, data?: unknown): void
WARN 레벨 로그
Parameters
- category: string
- message: string
- Optionaldata: unknown
Returns void
Implementation of ILogSystem.warn
- Defined in systems/log/LogSystem.ts:118

info

info(category: string, message: string, data?: unknown): void
INFO 레벨 로그
Parameters
- category: string
- message: string
- Optionaldata: unknown
Returns void
Implementation of ILogSystem.info
- Defined in systems/log/LogSystem.ts:125

debug

debug(category: string, message: string, data?: unknown): void
DEBUG 레벨 로그
Parameters
- category: string
- message: string
- Optionaldata: unknown
Returns void
Implementation of ILogSystem.debug
- Defined in systems/log/LogSystem.ts:132

trace

trace(category: string, message: string, data?: unknown): void
TRACE 레벨 로그
Parameters
- category: string
- message: string
- Optionaldata: unknown
Returns void
Implementation of ILogSystem.trace
- Defined in systems/log/LogSystem.ts:139

time

time(label: string): void
타이머 시작
Parameters
- label: string
Returns void
Implementation of ILogSystem.time
- Defined in systems/log/LogSystem.ts:148

timeEnd

timeEnd(label: string): number
타이머 종료 및 로그 출력
Parameters
- label: string
Returns number
소요 시간 (ms)
Implementation of ILogSystem.timeEnd
- Defined in systems/log/LogSystem.ts:159

measure

measure<T>(label: string, fn: () => T): T
함수 실행 시간 측정
Type Parameters
- T
Parameters
- label: string
- fn: () => T
Returns T
Implementation of ILogSystem.measure
- Defined in systems/log/LogSystem.ts:186

measureAsync

measureAsync<T>(label: string, fn: () => Promise<T>): Promise<T>
비동기 함수 실행 시간 측정
Type Parameters
- T
Parameters
- label: string
- fn: () => Promise<T>
Returns Promise<T>
Implementation of ILogSystem.measureAsync
- Defined in systems/log/LogSystem.ts:198

subscribe(handler: LogHandler): () => void
로그 handlers 등록
Parameters
- handler: LogHandler
Returns () => void
unsubscribe 함수
Implementation of ILogSystem.subscribe
- Defined in systems/log/LogSystem.ts:213

unsubscribe

unsubscribe(handler: LogHandler): void
로그 handlers 해제
Parameters
- handler: LogHandler
Returns void
Implementation of ILogSystem.unsubscribe
- Defined in systems/log/LogSystem.ts:221

getHistory

getHistory(filter?: LogHistoryFilter): LogEntry[]
로그 history 조회
Parameters
- Optionalfilter: LogHistoryFilter
Returns LogEntry[]
Implementation of ILogSystem.getHistory
- Defined in systems/log/LogSystem.ts:230

clearHistory

clearHistory(): void
history initialization

Returns void
Implementation of ILogSystem.clearHistory
- Defined in systems/log/LogSystem.ts:255

export

export(): string
로그 내보내기 (디버깅용)

Returns string
Implementation of ILogSystem.export
- Defined in systems/log/LogSystem.ts:262

createLogger

createLogger(category: string): CategoryLogger
특정 카테고리의 로거 생성
Parameters
- category: string
Returns CategoryLogger
- Defined in systems/log/LogSystem.ts:279

dispose

dispose(): void
리소스 cleanup

Returns void
Implementation of ILogSystem.dispose
- Defined in systems/log/LogSystem.ts:430

Class LogSystem

Remarks

Example

Implements

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns LogSystem

Methods

setLevel

Parameters

Returns void

getLevel

Returns LogLevel

setCategoryLevel

Parameters

Returns void

getCategoryLevel

Parameters

Returns LogLevel

isEnabled

Parameters

Returns boolean

error

Parameters

Returns void

warn

Parameters

Returns void

info

Parameters

Returns void

debug

Parameters

Returns void

trace

Parameters

Returns void

time

Parameters

Returns void

timeEnd

Parameters

Returns number

measure

Type Parameters

Parameters

Returns T

measureAsync

Type Parameters

Parameters

Returns Promise<T>

subscribe

Parameters

Returns () => void

unsubscribe

Parameters

Returns void

getHistory

Parameters

Returns LogEntry[]

clearHistory

Returns void

export

Returns string

createLogger

Parameters

Returns CategoryLogger

dispose

Returns void

Settings

On This Page