Measuring IDE Performance
What you'll learn: How to use TypeScript's diagnostic tools to pinpoint exactly what's slowing down your editor and causing laggy autocomplete.
Why Measure IDE Performance?
You know something's wrong when autocomplete takes seconds or your editor freezes while typing. But what exactly is causing it? Is it a complex type? A massive union? Poor project configuration? Without measurements, you're just guessing.
TypeScript provides built-in flags that let you trace and diagnose performance issues in the language service—the engine powering your IDE experience.
The Primary Diagnostic Tools
The --diagnostics Flag
This gives you a quick summary of compilation metrics. While primarily for build performance, it shows you the overall health of your type system:
tsc --diagnostics
You'll see output like file counts, total time, and memory usage—useful baseline numbers.
The --extendedDiagnostics Flag
This is your deep-dive tool. It breaks down where TypeScript spends its time during type-checking:
tsc --extendedDiagnostics
The output reveals time spent on type checking, binding, program structure, and I/O. Look for unexpectedly high numbers—they're your smoking guns.
The Power of --generateTrace
This is the gold standard for IDE performance investigation. It creates a detailed trace file you can load into Chrome DevTools:
tsc --generateTrace trace_output
This generates a folder with timing data. Open chrome://tracing in Chrome, load the trace.json file, and you'll see a flamegraph showing exactly which types take the longest to check. You can zoom into specific types, functions, and files to see where complexity explodes.
The @typescript/analyze-trace CLI tool can parse these traces and highlight the most expensive types automatically.
What to Look For
When analyzing traces and diagnostics:
- Hot types: Types that appear repeatedly with high instantiation counts
- Deep call stacks: Recursive or deeply nested conditional types
- Large unions: Types that expand into hundreds of variants
- File-level bottlenecks: Specific files that dominate check time
Key Takeaway: TypeScript's trace and diagnostics flags transform IDE performance problems from mysterious slowdowns into concrete, fixable bottlenecks—use them before attempting optimization.