js-debug

This repo contains the new, upcoming JavaScript debugger for VS Code. It's currently a work in progress, expect minor bugs and incompatibilities at this stage.

Installation

You can use this extension from the marketplace by:

1. Installing the js-debug-nightly extension,
2. Adding "debug.node.useV3": true and "debug.chrome.useV3": true to your user settings,
3. Then you should be able to run and debug your programs without changing your launch config. If you can't, then please file an issue.

Or alternatively by self-hosting:

1. Clone this repository and run npm install,
2. Then either:
   • Run gulp package to package a .vsix you can install manually, or
   • Run npm run compile, then open the repository in VS Code and select "Run Extension"
3. Then you should be able to run and debug your programs without changing your launch config. If you can't, then please file an issue.

Features

Multiple threads

• Attaching to relevant browser threads: page, out of process iframes, web workers, related service workers

  

• Node debugging auto-attaches to all Node sub-processes

  

• Full stack debugging with all targets at a glance.

  

Console

• Evaluate in selected execution context

  

• Unified console for everything: service workers, page, workers

  

• Top-level await in console

  

• Serialized console output

  

• Console message formatting improvements from CDT

  

• Per-thread Output with timestamps available post-session

  

• Complete command line API:

  • inspect(function) - reveal function definition

  • copy(value) - copies value into clipboard

  • queryObjects(prototype) - returns all heap objects of type

    

Debugging

• Instrumentation breakpoints

  

• Pretty print minified source with complete debugging support

  

  

• Step into async, step into Worker, etc

  

• All locations go through source maps: stack trace on pause, console methods, exceptions, function locations

• Breakpoints set in source maps are guranteed to be resolved in time (in newer V8 versions).

Contributing

This project welcomes contributions and suggestions. See CONTRIBUTING.md for details.