RxJS Debugging for Visual Studio Code
Never, ever use
tap(console.log)again.
Add non-intrusive debugging capabilities for RxJS applications to Visual Studio Code.
Features
- RxJS debugging, fully integrated with Visual Studio Code
- Works with RxJS 6.6.7 and newer
- Support for Node.js and Webpack-based RxJS applications
Requirements
- Visual Studio Code 1.61 or newer
- RxJS 6.6.7 or newer
- To debug NodeJS-based applications:
- Node.js 12 or newer
- To debug Webpack-based web applications:
- Webpack 5.60.0 or newer
- The latest @rxjs-debugging/runtime-webpack Webpack plugin (see here for setup instructions)
Usage
Operator Log Points
Operator log points make manually added console.log statements a thing of the past: RxJS Debugger detects operators automatically and recommends a log point. Hover the mouse cursor on the operator to add or remove a log point to the respective operator:
Once you launch your application with the JavaScript debugger built-in to Visual Studio Code, enabled log points display events of interest inline in the editor:
- Subscribe
- Emitted values (next, error, complete)
- Unsubscribe
By default, RxJS Debugger clears logged events from the editor after you stop the JavaScript debugger. You can customize this behavior in the settings.
Finally, you can toggle gutter indicators for recommended log points via the command palette:
Roadmap & Future Development
Refer to the milestones overview for planned, future iterations. The issue list provides an overview on all open development topics.
Contributing
"RxJS Debugging for Visual Studio Code" welcomes any type of contribution!
Playground
Jump right in and explore, how "RxJS Debugging for Visual Studio Code" can improve your RxJS debugging workflow:
https://github.com/swissmanu/playground-rxjs-debugging-for-vscode
Analytics Data
The "RxJS Debugging for Visual Studio Code" extension collects usage analytics data from users who opt-in. See ANALYTICS.md for more information on what data is collected and why.
Research
This extension is based on research by Manuel Alabor. See RESEARCH.md for more information.