Strategy

Strategies decide when buffered logs are flushed to the configured service. Each strategy exposes an eventEmitter and emits "send" when it is time to post logs.

const { strategy } = require("advanced-logger")

Built-in strategies:

• InstantStrategy — send on every log()
• OnBundleSizeStrategy — send when the buffer reaches maxBundle
• OnIntervalStrategy — throttle sends while logs are arriving
• OnRequestStrategy — send only when you call logger.sendAllLogs()

InstantStrategy

Sends as soon as a log is added. sendAllLogs() does not flush additional batches (each log already triggered a send).

const instantStrategy = new strategy.InstantStrategy()

OnBundleSizeStrategy

Optional maxBundle (default 100): flush when the in-memory store reaches that count.

const bundleStrategy = new strategy.OnBundleSizeStrategy({
    maxBundle: 123,
})

OnIntervalStrategy

Optional interval in milliseconds (default 15000). Uses lodash throttle with trailing edge: while logs keep arriving, sends happen at most once per interval—not on a fixed clock if the buffer is idle.

const intervalStrategy = new strategy.OnIntervalStrategy({
    interval: 10000,
})

Call logger.destroy() when disposing a logger that uses this strategy.

OnRequestStrategy

Does not send automatically. Flush manually:

const requestStrategy = new strategy.OnRequestStrategy()

// logger is an AdvancedLogger instance
logger.sendAllLogs()

Useful with ConsoleService, custom batching, or before page unload.

Custom implementation of strategy

Implement the strategy contract:

InstantStrategy and OnRequestStrategy in the library source are minimal references.

const { EventEmitter } = require("events")

class MyStrategy {
    constructor() {
        this.eventEmitter = new EventEmitter()
    }

    onAdd() {
        // example: flush when store has logs
        this.eventEmitter.emit("send")
    }

    onClear() {}

    sendAll() {
        this.eventEmitter.emit("send")
    }

    destroy() {
        this.eventEmitter.removeAllListeners()
    }
}

Wire it when creating the logger:

const logger = new AdvancedLogger({
    service: new service.ConsoleService(),
    strategy: new MyStrategy(),
})