log-class

Help you track the complete process of class member function calls with a single log line.

Usage

import { logClass, setLogLevel } from 'log-class'

setLogLevel(4)

@logClass()
class Manager {
    constructor(name: string, age: number) {
        this._test1 = new Staff(name + ' 1')
        this._test2 = new Staff(name + ' 2')
        this._age = age
    }

    show() {
        this.innerPrint(this._test1, this._age)
        this.innerPrint(this._test2, this._age)
        return `age: ${this._age}`
    }

    private innerPrint(testB: Staff, age: number) {
        testB.print(age)
    }

    private _test1: Staff
    private _test2: Staff
    private _age: number
}

@logClass({ keyName: 'name' })
class Staff {
    constructor(name: string) {
        this.name = name
    }

    readonly name: string

    print(age: number) {
        console.log('  - name:', this.name, 'age:', age)
        return age
    }
}

console.log('** start process **\n')

const testA = new Manager('Staff', 18)
testA.show()

console.log('\n** end process **')

logs generated:

** start process **

/-new Manager("Staff", 18)
|   /-new Staff("Staff 1")
|   \-new Staff{undefined}
|   /-new Staff("Staff 2")
|   \-new Staff{undefined}
\-new Manager
/-Manager.show()
|   /-Manager.innerPrint([Staff], 18)
|   |   /-Staff{Staff 1}.print(18)
  - name: Staff 1 age: 18
|   |   \-Staff{Staff 1}.print => 18
|   \-Manager.innerPrint => undefined
|   /-Manager.innerPrint([Staff], 18)
|   |   /-Staff{Staff 2}.print(18)
  - name: Staff 2 age: 18
|   |   \-Staff{Staff 2}.print => 18
|   \-Manager.innerPrint => undefined
\-Manager.show => "age: 18"

** end process **

Usage

/***
 * @param opts optional parameters for logging
 * @param opts.logger:  logger function to use, default is console.log
 * @param opts.level:   this class's log level, if level <= logLevel then show logs, default is 3
 * @param opts.keyName: when logging a class's instance, also show this[keyName] as identifier
 */
const logClass = (opts?: LogClassOpts) => {
    // ...
}

/***
 * @param level 0 <= level <= 5, initial logLevel is 0. if logClass's level <= logLevel, will show logs.
 */
const setLogLevel = (level = 3): void => {
    // ...
}