Course contentsShow
← TypeScript
Lesson 1728 of 1,79639. TypeScript PerformanceFree lesson

Loading Traces in Chrome DevTools

Learn how to open trace files in chrome://tracing to visualize what the compiler is doing over time.

Loading Traces in Chrome DevTools

What you'll learn: How to open and visualize TypeScript compiler trace files in Chrome's built-in performance analyzer to see exactly what's slowing down your type checking.

Understanding Trace Files

When you ran the TypeScript compiler with --generateTrace (from the previous lesson), it created a folder full of .json files that record every single operation the compiler performed. These files use the exact same format as Chrome's performance traces—which means you can load them into a tool that was originally built for analyzing web page performance.

Think of it like a flight recorder for your compiler: instead of just knowing "the build took 30 seconds," you can now see a timeline showing exactly when type checking happened, which files caused bottlenecks, and how long each internal operation took.

Opening Traces in Chrome

The magic URL you need is chrome://tracing. This is a special Chrome developer page that exists purely for analyzing trace data:

  1. Open any Chrome or Chromium-based browser
  2. Navigate to chrome://tracing
  3. Click the Load button in the top-left
  4. Select the trace.*.json files from your generated trace folder
  5. Chrome will visualize the timeline of compiler operations

What You'll See

The trace viewer shows a horizontal timeline with rows for different compiler processes and threads. You'll see bars representing operations like "checking file X," "resolving module Y," or "instantiating generic type Z." Longer bars mean slower operations.

You can zoom, pan, and click individual operations to see their duration and details. This reveals whether your slowdown comes from complex conditional types, deeply nested generics, or simply checking enormous files.

Key Takeaway: Chrome DevTools' tracing viewer at chrome://tracing transforms raw compiler trace files into an interactive timeline, revealing exactly where your TypeScript compilation time is spent.