This extension provides configurable pick-process command PickMatchedProcess while debugging Node.js program in vscode.
The vscode node debugger provides convenient configurations when trying to debug a node.js process. The Attach to Process task with command:PickProcess works perfectly:
The picker command showed all the the other programs that were launched with one of the various forms of --debug or --inspect arguments.
However, most of times users have to select the specific one manually because of the others are possibly just distractions, and there's no configurations to filter the listed processes.
This extension simply provide a command to find matched node processes. The matching rules can be defined via extension configurations listed below.
With this extension, you can use the command PickMatchedProcess to replace PickProcess when executing Attach to Process debugging configured in launch.json, to filter the process you want to focus. For Example:
// ./vscode/launch.json
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "attach",
"name": "Attach by Process ID",
"processId": "${command:PickMatchedProcess}",
"skipFiles": ["<node_internals>/**"]
}
]
}// ./vscode/settings.json
{
"nodeDebugProcessPicker.match": [
"**/app.js",
]
}When pressing F5 to execute this debugging task, the node process which its command name string matches **/app.js will be displayed, makes you focus on your specific program more easily.
You can configure the PickerMatchedProcess behavior through extension settings. It is recommended to use workspace settings to define match patterns in current workspace, rather than user settings. The available settings are listed below:
The glob patterns to test against command name string of available processes. The matched result will be included in the picker list. You can define multiple patterns here, if one pattern is matched, it will be in the picker list. For example:
**/app.jswill match node program started from/workspace/foo/bar/app.js;**/node_modules/electron/**/*will match electron program started from localnode_modulesdirectory, which is usually in development!**/server.jswill exclude the programs started from the file nameserver.js.
If the picker found only one matched process, attach it immediately, without manual pick-confirm. Defaults to true.
Please feel free to submit issues if you have any questions. Contribution is also welcomed :)