Files
clash-verge-rev/src/utils/debug.ts
T
2026-08-19 07:27:43 +08:00

54 lines
1.5 KiB
TypeScript

/**
* Debug logging is enabled when:
* - dev build (`import.meta.env.DEV`)
* - env flag `VITE_ENABLE_DEBUG_LOGS` is truthy (1/true/yes)
* - page sets `window.__VERGE_ENABLE_DEBUG_LOGS__ = true`
* - localStorage item `VERGE_DEBUG_LOGS` is truthy (1/true/yes)
*/
let cachedDebugEnabled: boolean | undefined
const parseStringFlag = (value: unknown) => {
const normalized = String(value ?? '')
.trim()
.toLowerCase()
if (!normalized) return false
return normalized === '1' || normalized === 'true' || normalized === 'yes'
}
const readGlobalFlag = (): boolean | null => {
if (typeof window === 'undefined') return null
const flag = (window as any).__VERGE_ENABLE_DEBUG_LOGS__
return typeof flag === 'boolean' ? flag : null
}
const readStoredFlag = (): boolean | null => {
if (typeof window === 'undefined') return null
try {
const stored = window.localStorage?.getItem('VERGE_DEBUG_LOGS')
return stored ? parseStringFlag(stored) : null
} catch {
return null
}
}
const computeDebugEnabled = (): boolean => {
if (import.meta.env.DEV) return true
if (parseStringFlag(import.meta.env.VITE_ENABLE_DEBUG_LOGS)) return true
const globalFlag = readGlobalFlag()
if (globalFlag !== null) return globalFlag
const storedFlag = readStoredFlag()
if (storedFlag !== null) return storedFlag
return false
}
const isDebugLoggingEnabled = () =>
cachedDebugEnabled ?? (cachedDebugEnabled = computeDebugEnabled())
export const debugLog = (...args: any[]) => {
if (!isDebugLoggingEnabled()) return
console.log(...args)
}