Client-Side Script Debugging
This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2019. Download it here
The Visual Studio debugger provides a comprehensive debugging environment for finding and correcting errors in client-side scripts in ASP.NET pages.
Opening Script Documents
You can see lists of server-side and client-side script documents in the Solution Explorer to view . You can open any script document from Solution Explorer. For more information, see How to: View Script Documents.
In Visual Studio, you cannot directly debug server-side code, but you can set a breakpoint in a server-side file. Visual Studio automatically maps the breakpoint to a corresponding location in the client-side file and creates a mapped breakpoint in the client-side code.
Manually or Automatically Attaching to Script
To begin debugging script in Visual Studio, the debugger must attach to the script you want to debug. This can happen manually or automatically.
You can manually attach by using the Visual Studio debugger interface to choose a running script process you want to attach to. For more information, see How to: Attach to Script.
The debugger automatically attaches to script when one of the following things occurs:
You hit a breakpoint set in script.
You hit a VBScript
Stopstatement or JScript
debuggerstatement in your script code.
The browser or server encounters a syntax or run time error in your script. When this occurs, a dialog box appears and have the option to begin debugging.
When you manually attach to script, the script process continues to run until it is somehow halted. You can halt it by choosing Break on the Debug menu.
When the debugger attaches automatically, script execution is halted at the line where the breakpoint,
debuggerstatement, or error occurred, or at the point where you chose to start debugging in Internet Explorer.
At that point, you can use the normal debugger facilities to begin debugging. For example, you can use Step commands to continue to execute your code line by line. You can use the Call Stack window to view and control script flow. You can use the variable windows or Immediate window to view or change variables and properties.
Enhanced Error Messages for Script Debugging
Visual Studio provides enhanced error messages for common script debugging problems. These messages do not appear unless you attach to Internet Explorer manually. If you encounter an error condition when Internet Explorer is opened automatically, try manually attaching so that you can see the error messages.
Debugging AJAX Script Applications
AJAX-enabled Web applications make heavy use of script code and pose special debugging challenges. For information about AJAX debugging techniques, see