microsoft/vscode-js-debug
Vscode Js Debug
This project is a diagnostic adapter that connects code editors and standalone tools to running runtime processes using the standard Debug Adapter Protocol. It functions as a JavaScript and TypeScript debug implementation that maps compiled code back to original source files using sourcemaps, allowing developers to set breakpoints, inspect variables, and evaluate expressions without manual configuration.
The tool handles cross-environment code execution by automatically attaching to child processes, worker threads, service workers, and terminal processes. It supports advanced debugging capabilities such as configuring conditional exception filters, inspecting WebAssembly binaries via DWARF symbols, intercepting function return values, and formatting minified sources for readability.
Additional features include capturing CPU performance profiles and memory heaps, monitoring HTTP network traffic, and translating renamed variables across views. The system also exposes active protocol socket addresses and provides extension integration points for companion tools.
Features
- JavaScript and TypeScript Debugging - Steps through JavaScript and TypeScript code, inspects variables, and evaluates expressions across runtimes.
- Sourcemap Management - Maps compiled JavaScript back to original source files using sourcemaps to set breakpoints and inspect state.
- Debugger Command APIs - Translates abstract editor commands into concrete execution controls for runtime debuggers.
- Debug Adapter Protocol Implementations - Connects editor interfaces to running runtime processes using the standard Debug Adapter Protocol.
- Runtime Debugging - Inspects and steps through code running in browsers, servers, and mobile applications.
- Runtime Debugging Protocols - Executes diverse programming languages through protocol-compliant adapters that unify diagnostics.
- Sourcemap Debuggers - Translates sourcemaps to step through and inspect original TypeScript sources without manual configuration.
- Debug Adapter Protocol Runtimes - Connects code editors to running browser and server runtimes to control execution using standard debug adapter protocols.
- Debug Session Management - Sets up parameters like working directories and environment variables to control debugging sessions.
- Child Process Debugging - Automatically intercepts and debugs spawned child processes, worker threads, and service workers.
- Heap and CPU Profilers - Captures CPU performance profiles and memory heaps for native visualization and analysis.
- Breakpoint Debugging - Pauses execution using conditional exception filters, instrumentation listeners, and call stack exclusions.
- Minified Code Debugging - Formats minified production scripts into readable layouts for easier inspection during debugging sessions.
- Source Path Mapping - Specifies file paths and source map locations to resolve running scripts back to original files.
- Terminal Session Capturing - Automatically attaches to terminal processes at startup to debug commands executed within terminal sessions.
- Terminal Debugging Integrations - Hooks into terminal commands and scripts at startup to launch debugging sessions instantly.
- Concurrent Thread Execution - Automatically attaches to worker threads and child processes while permitting step-through debugging.
- DWARF Symbol Debugging - Reads DWARF symbols from compiled WebAssembly binaries to step through low-level execution and inspect variables.
- Sourcemap Variable Mappings - Translates renamed identifiers across views and evaluation requests using sourcemap data.
- Conditional Exception Filters - Configures conditional exception filters to pause execution when specific errors occur during debugging.
- Application Performance Profiling - Captures CPU performance and memory heaps with sourcemap translation to analyze application resource usage.
