Course contentsShow
← Web Development
Lesson 2266 of 2,98241. Debugging TechniquesFree lesson

Breakpoints in Async Code

Debug promises, async/await, and callbacks by understanding how breakpoints interact with asynchronous execution.

Breakpoints in Async Code

What you'll learn: How to effectively pause and inspect asynchronous JavaScript execution using breakpoints, despite the non-linear flow of promises, async/await, and callbacks.

The Challenge of Async Debugging

When debugging synchronous code, breakpoints pause execution in a predictable, top-to-bottom order. Asynchronous code breaks this pattern—callbacks fire later, promises resolve on different turns of the event loop, and async/await suspends functions mid-execution. Setting a breakpoint inside an async function or promise handler requires understanding when that code actually runs.

How Breakpoints Interact with Async Execution

When you set a breakpoint inside a .then() handler, async function, or callback, execution will only pause when that code path is reached. This might be milliseconds or seconds after surrounding synchronous code has finished.

Example flow:

  1. You set a breakpoint inside an async function
  2. The function is called, but immediately yields at the first await
  3. Control returns to the call site
  4. Later, when the awaited promise resolves, execution resumes
  5. Only then does your breakpoint trigger

The same applies to callbacks passed to setTimeout() or event handlers fetched with XHR/Fetch breakpoints—the breakpoint won't hit until the callback is invoked.

Practical Debugging Strategy

Use Conditional Breakpoints to pause only when specific async conditions are met (like a particular response status). Combine with console.log before the async operation to confirm your code path is being entered. Remember: if a promise rejects or an error is thrown before your breakpoint, it may never trigger—set Exception Breakpoints as a safety net.

Key Takeaway: Breakpoints in async code pause execution only when the asynchronous callback, promise handler, or resumed async function actually executes—not when the async operation is initiated. Anticipate delays and use exception breakpoints to catch rejected promises.