resolveDebug() — tailwindcss Function Reference

Architecture documentation for the resolveDebug() function in env.ts from the tailwindcss codebase.

Function typescript NodeBridge NapiBinding

Entity Profile

NodeBridge→ NapiBinding→ resolveDebug() — tailwindcss Function Reference

Dependency Diagram

graph TD
  2ea1ae6f_145c_e3ab_ebfc_91a369eb2242["resolveDebug()"]
  e9df710b_baf8_da14_76dd_1e58ee266e35["env.ts"]
  2ea1ae6f_145c_e3ab_ebfc_91a369eb2242 -->|defined in| e9df710b_baf8_da14_76dd_1e58ee266e35
  style 2ea1ae6f_145c_e3ab_ebfc_91a369eb2242 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/@tailwindcss-node/src/env.ts lines 3–44

function resolveDebug(debug: typeof process.env.DEBUG) {
  if (typeof debug === 'boolean') {
    return debug
  }

  if (debug === undefined) {
    return false
  }

  // Environment variables are strings, so convert to boolean
  if (debug === 'true' || debug === '1') {
    return true
  }

  if (debug === 'false' || debug === '0') {
    return false
  }

  // Keep the debug convention into account:
  // DEBUG=* -> This enables all debug modes
  // DEBUG=projectA,projectB,projectC -> This enables debug for projectA, projectB and projectC
  // DEBUG=projectA:* -> This enables all debug modes for projectA (if you have sub-types)
  // DEBUG=projectA,-projectB -> This enables debug for projectA and explicitly disables it for projectB

  if (debug === '*') {
    return true
  }

  let debuggers = debug.split(',').map((d) => d.split(':')[0])

  // Ignoring tailwindcss
  if (debuggers.includes('-tailwindcss')) {
    return false
  }

  // Including tailwindcss
  if (debuggers.includes('tailwindcss')) {
    return true
  }

  return false
}