NCDbg is a debugger for Nashorn (the JavaScript engine in Java 8 and onward) that uses Google Chrome DevTools or Visual Studio Code (VSCode) as frontend.
NCDbg is an abbreviation of Nashorn Chrome Debugger. I chose that name because of my profound lack of imagination when it comes to naming things. Since VSCode can act as a debugger frontend as well (since 0.6.0), there is a great need for a better name. Suggestions are welcome!
Both Java 8 and Java 9 are supported. Please see the documentation for information about Java 9.
To compile in a Unix-like shell:
./gradlew compileScala
If you prefer a Windows command prompt, just use gradlew instead of ./gradlew.
To run tests:
./gradlew test
Note that at least one test is unstable. If the test suite fails, re-run it. If the failure persists, please open an issue.
If you use a globally installed Gradle, then you must use version 2.13 because of the ScalaTest plugin. If you use
another version, the version of the com.github.maiflai.scalatest plugin needs to be adjusted accordingly.
See build.gradle for details.
Documentation can be found in the docs folder.
VSCode has a separate documentation.
Pull requests are welcome! However, before creating a pull request, please open an issue to describe the missing/limited/faulty behavior that you intend to fix, along with a solution proposal.
In the absence of a proper style guide, please follow the style of existing code.
Please see CHANGELOG.md.
The code in this repository is licensed under the 3-Clause BSD license. See the LICENCE file for details.
This project is partly sponsored by my employer, factor10.
Twitter: @provegard