createDebugger() — vite Function Reference

Architecture documentation for the createDebugger() function in utils.ts from the vite codebase.

Function typescript ViteCore ConfigEngine called by 1

Entity Profile

ViteCore→ ConfigEngine→ createDebugger() — vite Function Reference

Dependency Diagram

graph TD
  23a2e685_f919_9578_27ba_bde71c122058["createDebugger()"]
  031bc221_67a8_c579_f2bf_bb30a08beeb2["utils.ts"]
  23a2e685_f919_9578_27ba_bde71c122058 -->|defined in| 031bc221_67a8_c579_f2bf_bb30a08beeb2
  5f780e97_091a_dfa9_1506_327f54d41dca["onRollupLog()"]
  5f780e97_091a_dfa9_1506_327f54d41dca -->|calls| 23a2e685_f919_9578_27ba_bde71c122058
  style 23a2e685_f919_9578_27ba_bde71c122058 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/vite/src/node/utils.ts lines 183–207

export function createDebugger(
  namespace: ViteDebugScope,
  options: DebuggerOptions = {},
): Debugger['log'] | undefined {
  const log = debug(namespace)
  const { onlyWhenFocused, depth } = options

  if (depth && log.inspectOpts && log.inspectOpts.depth == null) {
    log.inspectOpts.depth = options.depth
  }

  let enabled = log.enabled
  if (enabled && onlyWhenFocused) {
    const ns = typeof onlyWhenFocused === 'string' ? onlyWhenFocused : namespace
    enabled = !!DEBUG?.includes(ns)
  }

  if (enabled) {
    return (...args: [string, ...any[]]) => {
      if (!filter || args.some((a) => a?.includes?.(filter))) {
        log(...args)
      }
    }
  }
}