JerryScript Debugger & Chrome DevTools Proxy

April 24, 2018 ยท View on GitHub

License Build Status IRC Channel

Dependencies

  • node.js
  • yarn or npm (the steps below use yarn)

Installing

$ cd jerryscript-debugger-ts
$ yarn install

Building in watch mode

This will make the TypeScript compiler monitor the source files and re-build files whenever there is a change.

$ cd jerryscript-debugger-ts
$ yarn build:watch

Running tests

$ cd jerryscript-debugger-ts
$ yarn test

Running tests in watch mode

This will make the test runner monitor the source files and re-run the tests whenever there is a change.

$ cd jerryscript-debugger-ts
$ yarn test:watch

Running the linter

$ cd jerryscript-debugger-ts
$ yarn lint

Using

Build and run JerryScript with the debugger enabled. For example, with the JerryScript Linux build:

$ cd jerryscript
$ python tools/build.py --jerry-debugger=on --jerry-libc=off
$ ./build/bin/jerry --start-debug-server --log-level 2 /path/to/source.js

Have Chrome running and visit the URL chrome://inspect, and click "Open dedicated DevTools for Node."

Finally, run this project's proxy application:

$ cd jerryscript-debugger-ts
$ ./jerry-debugger.sh

This should connect to the debugger and give focus to the DevTools window to start debugging.

Contributing

The project can only accept contributions which are licensed under the Apache License 2.0 and are signed according to the JerryScript Developer's Certificate of Origin. For further information please see our Contribution Guidelines.

License

This library is open source software under the Apache License 2.0. Complete license and copyright information can be found in the source code.

Copyright JS Foundation and other contributors, http://js.foundation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.