Optimize console log capture in production

Only capture log/info levels in dev builds or when verbose mode is
explicitly enabled in Developer Mode. Always capture error/warn for
bug tracking. Reduces GC/CPU overhead in production builds.

Adds toggle in Settings > Developer Mode to enable verbose capture
when debugging production issues.
This commit is contained in:
vicrodh committed 2026-02-12 13:34:02 -06:00
1 parent 51a24de9cb
commit 14e657e8af
6 files changed
+96 -9

No files matched your search

+45 -5
View File
@@ -4,6 +4,11 @@
* Wraps console.log/warn/error/info to capture browser-side logs
* for the Developer Mode "View Logs" modal. Original console methods
* are still called — no breakage.
*
* Performance optimization:
* - error/warn: Always captured (low frequency, high value for bug reports)
* - log/info: Only captured in dev builds OR when verbose mode is enabled
* (reduces GC/CPU overhead in production)
*/
interface ConsoleEntry {
@@ -16,6 +21,10 @@ const MAX_ENTRIES = 2000;
let entries: ConsoleEntry[] = [];
let initialized = false;
// Verbose capture mode - when true, captures log/info even in production
// Can be enabled via Developer Mode for debugging production issues
let verboseCapture = false;
// Keep references to the real console methods
const originalConsole = {
log: console.log.bind(console),
@@ -48,14 +57,32 @@ function capture(level: ConsoleEntry['level'], args: unknown[]) {
}
}
// Check if we should capture log/info (verbose levels)
// In dev builds: always capture everything
// In production: only capture if verbose mode is explicitly enabled
function shouldCaptureVerbose(): boolean {
return import.meta.env.DEV || verboseCapture;
}
export function initConsoleCapture() {
if (initialized) return;
initialized = true;
// log/info: Only capture in dev OR when verbose mode is enabled
console.log = (...args: unknown[]) => {
capture('log', args);
if (shouldCaptureVerbose()) {
capture('log', args);
}
originalConsole.log(...args);
};
console.info = (...args: unknown[]) => {
if (shouldCaptureVerbose()) {
capture('info', args);
}
originalConsole.info(...args);
};
// warn/error: Always capture (valuable for bug reports)
console.warn = (...args: unknown[]) => {
capture('warn', args);
originalConsole.warn(...args);
@@ -64,10 +91,23 @@ export function initConsoleCapture() {
capture('error', args);
originalConsole.error(...args);
};
console.info = (...args: unknown[]) => {
capture('info', args);
originalConsole.info(...args);
};
}
/** Enable verbose capture (log/info) in production - for debugging */
export function enableVerboseCapture() {
verboseCapture = true;
originalConsole.info('[ConsoleCapture] Verbose capture enabled');
}
/** Disable verbose capture (log/info) in production */
export function disableVerboseCapture() {
verboseCapture = false;
originalConsole.info('[ConsoleCapture] Verbose capture disabled');
}
/** Check if verbose capture is currently enabled */
export function isVerboseCaptureEnabled(): boolean {
return verboseCapture;
}
export function getConsoleLogs(): ConsoleEntry[] {