Add --duration flag for zero-overhead duration measurement

webpro · webpro · commit d4b59d89bff6 · 2026-05-14T20:25:05.000+02:00
diff --git a/packages/knip/src/cli.ts b/packages/knip/src/cli.ts
@@ -95,7 +95,7 @@ const main = async () => {
     if (perfObserver.isMemoryUsageEnabled && !args['memory-realtime'])
       console.log(`\n${perfObserver.getMemoryUsageTable()}`);
 
-    if (perfObserver.isEnabled) {
+    if (perfObserver.isEnabled || perfObserver.isDurationEnabled) {
       const duration = perfObserver.getCurrentDurationInMs();
       console.log('\nTotal running time:', prettyMilliseconds(duration));
       perfObserver.reset();
diff --git a/packages/knip/src/util/Performance.ts b/packages/knip/src/util/Performance.ts
@@ -11,13 +11,15 @@ const { values } = parseArgs({
     'performance-fn': { type: 'string', multiple: true },
     memory: { type: 'boolean' },
     'memory-realtime': { type: 'boolean' },
+    duration: { type: 'boolean' },
   },
 });
 
 const timerifyOnlyFnName = values['performance-fn'];
 const isMemoryRealtime = !!values['memory-realtime'];
 const isTimerifyFunctions = !!values.performance || !!timerifyOnlyFnName;
 const isMemoryUsageEnabled = !!values.memory || isMemoryRealtime;
+const isDurationEnabled = !!values.duration;
 
 export const timerify = <T extends (...params: any[]) => any>(fn: T, name: string = fn.name): T => {
   if (!isTimerifyFunctions) return fn;
@@ -56,6 +58,7 @@ class Performance {
   isEnabled: boolean;
   isTimerifyFunctions: boolean;
   isMemoryUsageEnabled: boolean;
+  isDurationEnabled: boolean;
   startTime = 0;
   endTime = 0;
   perfEntries: PerformanceEntry[] = [];
@@ -65,10 +68,11 @@ class Performance {
   fnObserver?: PerformanceObserver;
   memObserver?: PerformanceObserver;
 
-  constructor({ isTimerifyFunctions = false, isMemoryUsageEnabled = false }) {
+  constructor({ isTimerifyFunctions = false, isMemoryUsageEnabled = false, isDurationEnabled = false }) {
     this.isEnabled = isTimerifyFunctions || isMemoryUsageEnabled;
     this.isTimerifyFunctions = isTimerifyFunctions;
     this.isMemoryUsageEnabled = isMemoryUsageEnabled;
+    this.isDurationEnabled = isDurationEnabled;
 
     this.startTime = performance.now();
     const instanceId = Math.floor(performance.now() * 100);
@@ -206,4 +210,4 @@ class Performance {
   }
 }
 
-export const perfObserver = new Performance({ isTimerifyFunctions, isMemoryUsageEnabled });
+export const perfObserver = new Performance({ isTimerifyFunctions, isMemoryUsageEnabled, isDurationEnabled });
diff --git a/packages/knip/src/util/cli-arguments.ts b/packages/knip/src/util/cli-arguments.ts
@@ -55,6 +55,7 @@ Troubleshooting
   --memory-realtime        Log memory usage in realtime
   --performance            Measure count and running time of key functions and display stats table
   --performance-fn [name]  Measure only function [name]
+  --duration               Print total running time (zero overhead, no instrumentation)
   --trace                  Show trace output
   --trace-dependency [name] Show files that import the named dependency
   --trace-export [name]    Show trace output for named export(s)
@@ -115,6 +116,7 @@ export default function parseCLIArgs() {
       'preprocessor-options': { type: 'string' },
       reporter: { type: 'string', multiple: true },
       'reporter-options': { type: 'string' },
+      duration: { type: 'boolean' },
       strict: { type: 'boolean' },
       trace: { type: 'boolean' },
       'trace-dependency': { type: 'string' },
