Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
e556b07
commit 84fe9f0
Showing
25 changed files
with
381 additions
and
329 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,9 +1,9 @@ | ||
# Microsoft Open Source Code of Conduct | ||
|
||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
|
||
Resources: | ||
|
||
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) | ||
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) | ||
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns | ||
# Microsoft Open Source Code of Conduct | ||
|
||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
|
||
Resources: | ||
|
||
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) | ||
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) | ||
- Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,29 +1,29 @@ | ||
# Contributing | ||
|
||
This project welcomes contributions and suggestions. Most contributions require you to agree to a | ||
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us | ||
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. | ||
|
||
When you submit a pull request, a CLA bot will automatically determine whether you need to provide | ||
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions | ||
provided by the bot. You will only need to do this once across all repos using our CLA. | ||
|
||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or | ||
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. | ||
|
||
## Development | ||
|
||
For basic development of the extension, you can run: | ||
|
||
1. Clone the repo and run `npm install` | ||
2. Run `npm run watch` in a terminal. This will compile and watch for changes in sources. | ||
3. Run the `Extension` launch configuration. | ||
|
||
For debugging the companion app used to launch browsers from remotes, the process is similar: | ||
|
||
- Also clone `vscode-js-debug-companion` as a sibling directory to `vscode-js-debug`. | ||
- Run `npm run watch` for the companion. | ||
- Run the `Extension and Companion` launch configuration. | ||
|
||
This will cause both js-debug and its companion to boot. It sets an environment variable that forces the companion app to be used for launching the browser. | ||
# Contributing | ||
|
||
This project welcomes contributions and suggestions. Most contributions require you to agree to a | ||
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us | ||
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. | ||
|
||
When you submit a pull request, a CLA bot will automatically determine whether you need to provide | ||
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions | ||
provided by the bot. You will only need to do this once across all repos using our CLA. | ||
|
||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or | ||
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. | ||
|
||
## Development | ||
|
||
For basic development of the extension, you can run: | ||
|
||
1. Clone the repo and run `npm install` | ||
2. Run `npm run watch` in a terminal. This will compile and watch for changes in sources. | ||
3. Run the `Extension` launch configuration. | ||
|
||
For debugging the companion app used to launch browsers from remotes, the process is similar: | ||
|
||
- Also clone `vscode-js-debug-companion` as a sibling directory to `vscode-js-debug`. | ||
- Run `npm run watch` for the companion. | ||
- Run the `Extension and Companion` launch configuration. | ||
|
||
This will cause both js-debug and its companion to boot. It sets an environment variable that forces the companion app to be used for launching the browser. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,99 +1,99 @@ | ||
# 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`, | ||
1. 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" | ||
1. 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 | ||
|
||
<img width="359" alt="Screen Shot 2019-07-25 at 9 27 36 AM" src="https://user-images.githubusercontent.com/883973/61891435-803cd380-aebe-11e9-8c27-1af5d1fdab43.png"> | ||
|
||
- Node debugging auto-attaches to all Node sub-processes | ||
|
||
<img width="273" alt="Screen Shot 2019-07-30 at 4 16 15 PM" src="https://user-images.githubusercontent.com/883973/62171895-67308a00-b2e5-11e9-832a-0867cf2ea411.png"> | ||
|
||
* Full stack debugging with all targets at a glance. | ||
|
||
<img width="320" alt="Screen Shot 2019-07-30 at 4 13 21 PM" src="https://user-images.githubusercontent.com/883973/62171782-03a65c80-b2e5-11e9-958b-73582efd513c.png"> | ||
|
||
### Console | ||
|
||
- Evaluate in selected execution context | ||
|
||
<img width="652" alt="Screen Shot 2019-07-25 at 9 29 47 AM" src="https://user-images.githubusercontent.com/883973/61891554-c2feab80-aebe-11e9-9f30-38f057c7f722.png"> | ||
|
||
- Unified console for everything: service workers, page, workers | ||
|
||
<img width="504" alt="Screen Shot 2019-07-22 at 9 54 30 PM" src="https://user-images.githubusercontent.com/883973/61683685-4d7eb980-accb-11e9-959a-cc33eff6f9c6.png"> | ||
|
||
- Top-level await in console | ||
|
||
<img width="743" alt="Screen Shot 2019-07-22 at 9 40 36 PM" src="https://user-images.githubusercontent.com/883973/61683166-61292080-acc9-11e9-8416-e997d8ed3afc.png"> | ||
|
||
- Serialized console output | ||
|
||
<img width="245" alt="Screen Shot 2019-07-22 at 9 42 03 PM" src="https://user-images.githubusercontent.com/883973/61683220-97ff3680-acc9-11e9-98db-e6d199023647.png"> | ||
|
||
- Console message formatting improvements from CDT | ||
|
||
<img width="612" alt="Screen Shot 2019-07-22 at 10 01 08 PM" src="https://user-images.githubusercontent.com/883973/61683910-3be9e180-accc-11e9-9a48-8930f0db3f9b.png"> | ||
|
||
- Per-thread Output with timestamps available post-session | ||
|
||
<img width="324" alt="Screen Shot 2019-07-24 at 10 28 05 PM" src="https://user-images.githubusercontent.com/883973/61848257-5ce43b00-ae62-11e9-922c-a93073c0266b.png"> | ||
|
||
<img width="751" alt="Screen Shot 2019-07-24 at 10 29 43 PM" src="https://user-images.githubusercontent.com/883973/61848317-8e5d0680-ae62-11e9-88db-5017ed58a430.png"> | ||
|
||
- Complete command line API: | ||
|
||
- `inspect(function)` - reveal function definition | ||
- `copy(value)` - copies value into clipboard | ||
- `queryObjects(prototype)` - returns all heap objects of type | ||
|
||
<img width="259" alt="Screen Shot 2019-07-22 at 10 32 03 PM" src="https://user-images.githubusercontent.com/883973/61685138-8bcaa780-acd0-11e9-99d9-151c2839b5f6.png"> | ||
|
||
### Debugging | ||
|
||
- Instrumentation breakpoints | ||
|
||
<img width="285" alt="Screen Shot 2019-07-22 at 9 50 35 PM" src="https://user-images.githubusercontent.com/883973/61683560-c16c9200-acca-11e9-9d63-483b9c3d48ee.png"> | ||
|
||
<img width="604" alt="Screen Shot 2019-07-22 at 9 50 10 PM" src="https://user-images.githubusercontent.com/883973/61683564-c4678280-acca-11e9-959a-dbeb49fc8716.png"> | ||
|
||
- Pretty print minified source with complete debugging support | ||
|
||
<!--img width="464" alt="Screen Shot 2019-07-22 at 9 55 22 PM" src="https://user-images.githubusercontent.com/883973/61683714-6c7d4b80-accb-11e9-92ae-084e3b4f36e7.png"--> | ||
|
||
![pretty_print](https://user-images.githubusercontent.com/883973/61990381-71f0d380-aff4-11e9-95ae-10f2b1a732ec.gif) | ||
|
||
|
||
<img width="553" alt="Screen Shot 2019-07-22 at 9 56 12 PM" src="https://user-images.githubusercontent.com/883973/61683776-a9e1d900-accb-11e9-9884-f7494b1d8fc4.png"> | ||
|
||
- Step into async, step into Worker, etc | ||
|
||
![step_into](https://user-images.githubusercontent.com/883973/61990326-2c7fd680-aff3-11e9-9602-ba4b25c7f138.gif) | ||
|
||
- 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](CONTRIBUTING.md) for details. | ||
# 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`, | ||
1. 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" | ||
1. 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 | ||
|
||
<img width="359" alt="Screen Shot 2019-07-25 at 9 27 36 AM" src="https://user-images.githubusercontent.com/883973/61891435-803cd380-aebe-11e9-8c27-1af5d1fdab43.png"> | ||
|
||
- Node debugging auto-attaches to all Node sub-processes | ||
|
||
<img width="273" alt="Screen Shot 2019-07-30 at 4 16 15 PM" src="https://user-images.githubusercontent.com/883973/62171895-67308a00-b2e5-11e9-832a-0867cf2ea411.png"> | ||
|
||
* Full stack debugging with all targets at a glance. | ||
|
||
<img width="320" alt="Screen Shot 2019-07-30 at 4 13 21 PM" src="https://user-images.githubusercontent.com/883973/62171782-03a65c80-b2e5-11e9-958b-73582efd513c.png"> | ||
|
||
### Console | ||
|
||
- Evaluate in selected execution context | ||
|
||
<img width="652" alt="Screen Shot 2019-07-25 at 9 29 47 AM" src="https://user-images.githubusercontent.com/883973/61891554-c2feab80-aebe-11e9-9f30-38f057c7f722.png"> | ||
|
||
- Unified console for everything: service workers, page, workers | ||
|
||
<img width="504" alt="Screen Shot 2019-07-22 at 9 54 30 PM" src="https://user-images.githubusercontent.com/883973/61683685-4d7eb980-accb-11e9-959a-cc33eff6f9c6.png"> | ||
|
||
- Top-level await in console | ||
|
||
<img width="743" alt="Screen Shot 2019-07-22 at 9 40 36 PM" src="https://user-images.githubusercontent.com/883973/61683166-61292080-acc9-11e9-8416-e997d8ed3afc.png"> | ||
|
||
- Serialized console output | ||
|
||
<img width="245" alt="Screen Shot 2019-07-22 at 9 42 03 PM" src="https://user-images.githubusercontent.com/883973/61683220-97ff3680-acc9-11e9-98db-e6d199023647.png"> | ||
|
||
- Console message formatting improvements from CDT | ||
|
||
<img width="612" alt="Screen Shot 2019-07-22 at 10 01 08 PM" src="https://user-images.githubusercontent.com/883973/61683910-3be9e180-accc-11e9-9a48-8930f0db3f9b.png"> | ||
|
||
- Per-thread Output with timestamps available post-session | ||
|
||
<img width="324" alt="Screen Shot 2019-07-24 at 10 28 05 PM" src="https://user-images.githubusercontent.com/883973/61848257-5ce43b00-ae62-11e9-922c-a93073c0266b.png"> | ||
|
||
<img width="751" alt="Screen Shot 2019-07-24 at 10 29 43 PM" src="https://user-images.githubusercontent.com/883973/61848317-8e5d0680-ae62-11e9-88db-5017ed58a430.png"> | ||
|
||
- Complete command line API: | ||
|
||
- `inspect(function)` - reveal function definition | ||
- `copy(value)` - copies value into clipboard | ||
- `queryObjects(prototype)` - returns all heap objects of type | ||
|
||
<img width="259" alt="Screen Shot 2019-07-22 at 10 32 03 PM" src="https://user-images.githubusercontent.com/883973/61685138-8bcaa780-acd0-11e9-99d9-151c2839b5f6.png"> | ||
|
||
### Debugging | ||
|
||
- Instrumentation breakpoints | ||
|
||
<img width="285" alt="Screen Shot 2019-07-22 at 9 50 35 PM" src="https://user-images.githubusercontent.com/883973/61683560-c16c9200-acca-11e9-9d63-483b9c3d48ee.png"> | ||
|
||
<img width="604" alt="Screen Shot 2019-07-22 at 9 50 10 PM" src="https://user-images.githubusercontent.com/883973/61683564-c4678280-acca-11e9-959a-dbeb49fc8716.png"> | ||
|
||
- Pretty print minified source with complete debugging support | ||
|
||
<!--img width="464" alt="Screen Shot 2019-07-22 at 9 55 22 PM" src="https://user-images.githubusercontent.com/883973/61683714-6c7d4b80-accb-11e9-92ae-084e3b4f36e7.png"--> | ||
|
||
![pretty_print](https://user-images.githubusercontent.com/883973/61990381-71f0d380-aff4-11e9-95ae-10f2b1a732ec.gif) | ||
|
||
|
||
<img width="553" alt="Screen Shot 2019-07-22 at 9 56 12 PM" src="https://user-images.githubusercontent.com/883973/61683776-a9e1d900-accb-11e9-9884-f7494b1d8fc4.png"> | ||
|
||
- Step into async, step into Worker, etc | ||
|
||
![step_into](https://user-images.githubusercontent.com/883973/61990326-2c7fd680-aff3-11e9-9602-ba4b25c7f138.gif) | ||
|
||
- 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](CONTRIBUTING.md) for details. |
Oops, something went wrong.