Debugging Angular CLI Applications in Visual Studio Code
In this post, we are going to create an Angular CLI application, then add configuration to debug it in Visual Studio Code.
TLDR - For an Angular CLI application, create a debug configuration in VS Code, install the Debugger for Chrome extension, then run in debug mode.
<!-- TOC -->
<!-- /TOC -->
Learn VS Code
If you're interested in learning more about VS Code, you definitely want to check out the upcoming Learn VS Code course.
Creating a Starter Project
To be able to test an Angular CLI application, you need an Angular CLI application :) I'll provide the basic steps, but for more reference on how to get started look at the Angular CLI page.
First, you'll need to install the Angular CLI.
npm install -g @angular/cli
After that finishes, you'll need to actually generate your new application. This will take a bit as it needs to install LOTS of NPM packages.
ng new my-app
Open the project in VS Code and you should see the following.
Now, that you've got your new fancy Angular app, go ahead and run it to make sure everything looks right.
Should look like this.
Creating Debug Configuration
Assuming you've made it this far, we are ready to start debugging! Before we do, however, it's worth understanding how configuring debugging in VS Code works. Basically debug configurations are saved in a launch.json file which is stored inside of a .vscode folder. This .vscode folder is used to store different configurations for Code including our required debugging stuff.
Before you create your debug configuration, you need to install the Debugger for Chrome extension. Find and install this extension from the extension tab in VS Code. After installing, reload VS Code.
Now, to create a debug configuration, you can open the debug panel (the bug looking button on the left panel). At the top of the debug panel, you should see a dropdown that says "No Configurations".
To the right of that dropdown, there is a gear icon. Click this button to have VS Code automatically generate that
.vscode folder and
launch.json file mentioned above.
Then choose Chrome.
You should get the following configuration created for you.
The only thing we need to do is update the port from 8080 to 4200.
Now we're ready! Go ahead and click the play button at the top of the Debug panel which will launch an instance of Chrome in debug mode. Keep in mind your app should already be running from using ng serve earlier. In VS Code, you should see the Debug toolbar pop up.
With this up and running, you can set a breakpoint in your App.component.ts. Open up your App.component.ts and add a breakpoint inside of the component by clicking in the gutter (to the left of the line numbers). Should look like this.
Now, refresh debugging by clicking the refresh button on the debugging toolbar. This should open your application again and trigger this breakpoin. You should be directed back to VS Code directly to the place where you set your breakpoint.
Again, if you're interested in learning more about VS Code, you'll definitely want to check out the upcoming Learn VS Code course.
If you have any follow up questions or comments, leave one below of find me on twitter @jamesqquick.
For video content, check out my YouTube Channel