[Osaka/Yokohama/Tokushima] Looking for infrastructure/server side engineers!

[Osaka/Yokohama/Tokushima] Looking for infrastructure/server side engineers!

[Deployed by over 500 companies] AWS construction, operation, maintenance, and monitoring services

[Deployed by over 500 companies] AWS construction, operation, maintenance, and monitoring services

[Successor to CentOS] AlmaLinux OS server construction/migration service

[Successor to CentOS] AlmaLinux OS server construction/migration service

[For WordPress only] Cloud server “Web Speed”

[For WordPress only] Cloud server “Web Speed”

[Cheap] Website security automatic diagnosis “Quick Scanner”

[Cheap] Website security automatic diagnosis “Quick Scanner”

[Reservation system development] EDISONE customization development service

[Reservation system development] EDISONE customization development service

[Registration of 100 URLs is 0 yen] Website monitoring service “Appmill”

[Registration of 100 URLs is 0 yen] Website monitoring service “Appmill”

[Compatible with over 200 countries] Global eSIM “Beyond SIM”

[Compatible with over 200 countries] Global eSIM “Beyond SIM”

[If you are traveling, business trip, or stationed in China] Chinese SIM service “Choco SIM”

[If you are traveling, business trip, or stationed in China] Chinese SIM service “Choco SIM”

[Global exclusive service] Beyond's MSP in North America and China

[Global exclusive service] Beyond's MSP in North America and China

[YouTube] Beyond official channel “Biyomaru Channel”

[YouTube] Beyond official channel “Biyomaru Channel”

Debugging Node.js with Visual Studio Code

Hello.
I'm Mandai, in charge of Wild on the development team.

What kind of editor do you use when developing Node.js?
On the other hand, if you ask me what to use, I would have no hesitation in recommending Visual Studio Code (VSCode), which is an extremely capable debugging tool!

This time, I will introduce how to use VSCode's extremely powerful debugging tool.

 

Installation of nodemon for debugging

Speaking of Node.js, when I think of a tool that automatically restarts when a source is modified, I remember it as "node-dev" in the past, but recently it seems like nodemon is being used.

The official VSCode website also seems to use Nodemon, so I would like to follow the trend and use Nodemon here.

To use nodemon, you just need to install it with npm, so it's very easy.
Is it better to install globally? That's what I thought, so I installed it with the "-g" option.

# sudo npm install nodemon -g if necessary

 

The preliminary preparations are now complete.

 

launch.json settings

Configure launch.json to set launch options.
If you select "Open configuration" from the debug menu, launch.json will be automatically created.
It's already done to a certain extent, so all you have to do is make some corrections here and there.

Clicking the images below in numerical order will add items to launch.json.

launch.json configuration addition steps

At the bottom right of the launch.json screen, you will see a button called "Add Item", so press it.
New setting items will be added and the cursor will be moved, so scroll down the options and you will see an item called ``Node.js: nodemon setup'', so select this.

From here, change the settings to suit your individual environment.

I will list some of the most common ones that are frequently revised.

 

program

The program key specifies the file that will be the entry point for the Node.js application you are developing.

"${workspaceRoot}" will be replaced with the path to the folder open in VSCode, so change the path from there as necessary.

Regardless of the "cwd" item described below, a directory path that includes ${workspaceRoot} is required.

 

cwd

If this is set, the working directory will be changed before starting the Node.js application.

It's a bit complicated, but you can start the application without setting cwd (because you specify an absolute path with the program key), but if you use a relative path inside the application, the current directory where the program was executed Since a relative path starting from is selected, a "file not exists" error will occur.

 

example
  • Directory opened in VSCode
    • /path/to/hoge
  • Absolute path of app.js
    • /path/to/hoge/node/app.js

In the above case, the values ​​of the program and cwd keys are as follows.

  • program
    • ${workspaceRoot}/node/app.js
  • cwd
    • ${workspaceRoot}/node

 

args

When starting a Node.js application, define the necessary arguments as an array in the args key.

Since it is not specified in key/value format, the value is expanded as is as an argument.

"args": [ "-hoge", "--fuga=1", "-a 1", "--port 8080", "--socket", "/path/to/socket" ]

 

If you launch a Node.js application with launch.json with the args key as above, it will be launched with the command below.

nodemon --inspect=28106 --debug-brk app.js -hoge --fuga=1 "-a 1" "--port 8080" --socket /path/to/socket

 

What you need to be careful about is values ​​that include spaces, and the way you write them will change depending on whether you want to pass the string "-a 1" or specify 1 for the -a option.

It may not seem right, but if you specify it in the form "-a 1", it will be converted into an argument as a 4-character string, so how to specify the args key when specifying 1 for the -a option is

"args": [ "-a", "1" ]

 

You will need to specify the values ​​separately.
Therefore, the order of the args key arrangement is important.

 

runtimeArgs

Specifies the program arguments specified in runtimeExecutable.
runtimeExecutable is node by default, but you can choose from various options such as nodemon or gulp.

 

env

Specifies environment variables to be specified at runtime.

On Linux, this is the value passed to the env command, and on Windows, it is the value passed to $env.

It's hard to tell which env, runtimeArgs, and args are which, but if you run it on Linux, it will look like the following.

env [env] node [runtimeArgs] app.js [args]

 

It's like a mathematical formula, so it might be easier to memorize it.

 

Launch the app from VSCode

After setting launch.json, try launching it from VSCode.

The startup procedure is easy, just click as shown in the image below.

Debug startup procedure

If it launches successfully, try accessing the application using a browser.
You should be able to access it as before.

You can set a breakpoint by clicking on the left side of the line number in the editor, so if you stop at a suspicious part, you can also check the value contained in the variable at that point.

Debugging

When a program is interrupted, a bar like the one below will appear during debugging, so you can press it to step through the program.

debugging tools

After that, make good use of the watch expressions on the left that can display defined variables and objects, the call stack that displays the functions passed through until the breakpoint is processed, and the list of set breakpoints. , let's keep increasing debugging efficiency!

 

Debugging not just Node.js

VSCode's debugging tools seem to be able to debug not only Node.js but also Python.
Templates for major frameworks such as django and flask are preset, so you can debug with the same experience as with Node.js applications.

 

summary

What do you think of VSCode's extremely easy-to-use debugging tool?
I have the impression that VSCode inherits the best features of Visual Studio, such as the ease of use of IntelliSense and the excellent debugging tools.

 
That's it.

If you found this article helpful , please give it a like!
0
Loading...
0 votes, average: 0.00 / 10
9,673
X facebook Hatena Bookmark pocket
[2025.6.30 Amazon Linux 2 support ended] Amazon Linux server migration solution

[2025.6.30 Amazon Linux 2 support ended] Amazon Linux server migration solution

The person who wrote this article

About the author

Yoichi Bandai

My main job is developing web APIs for social games, but I'm also fortunate to be able to do a lot of other work, including marketing.
Furthermore, my portrait rights in Beyond are treated as CC0 by him.