Skip to content
šŸ¦Š Immediately Open Chrome DevTools when debugging Node.js apps
JavaScript HTML
Branch: master
Clone or download
darcyclarke Update standard-version to the latest version šŸš€ (#175)
Update standard-version to the latest version šŸš€
Latest commit c61908a Nov 8, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue templates Jul 25, 2019
bin Fix up linting issues Jul 22, 2019
extension Updating core Jun 14, 2019
scripts Fix up linting issues Jul 22, 2019
test Add changes to server Feb 23, 2018
.babelrc Fix up project May 19, 2017
.editorconfig Fix up project May 19, 2017
.eslintignore Change eslint ignore directories to add the extension Jul 2, 2019
.eslintrc.json Add chrome extension May 20, 2017
.gitignore Remove npmrc Oct 3, 2019
.nvmrc Update to node 10 in .nvmrc Apr 26, 2018
.snyk fix: package.json & .snyk to reduce vulnerabilities Oct 4, 2019
.travis.yml
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Aug 14, 2017
LICENSE
README.md
RESEARCH.md Fix issue with yargs and nodemon integration Feb 16, 2018
appveyor.yml Update test environments v2 Feb 16, 2018
contributing.md docs(Docs): Added commitizen to documentation/changelog workflow Aug 19, 2017
index.js Remove the need for an extension server Aug 15, 2017
package.json chore(package): update standard-version to version 7.0.1 Nov 7, 2019

README.md

npm version Build Status Build status Known Vulnerabilities Dependency Status

rawkit

rawkit grabs the chrome inspector URL returned from the node --inspect command and immediately opens devtools. No more clicking, selecting, copying/pasting or navigating. Just run the command and jump into debugging.

Installation & Usage

$ npm install -g rawkit
...
$ rawkit example.js

With npx

$ npx rawkit example.js

tutorial

Features

  • āœ… Works offline
  • āœ… Supports nodemon & reloading
  • āœ… Supports legacy Node <v7.x debugging protocols & devtools

Options

By default, running rawkit can detect any main script that's been defined in the current working directory's package.json and run that. It also will detect the version of Node.js you're running to determine whether or not to fallback to older debug APIs.

--inspect-brk or b

To break on the first line of the application code.

--inspect-port or p

The debugger port. Defaults to 9229.

--canary or c

Open the devtools in canary.

--nodemon or n

Use nodemon to run/watch your node process & reload when files change. rawkit supports all the default configuration options for nodemon including execMap inside your project's package.json or nodemon.json files.

--silent or s

Hide stdout/stderr output from child process in the terminal window.

--executable=[name] or e

Specify the name of the executable. Defaults to google chrome.

Note: --executable is an experimental feature as rawkit typically does all the work to determine the right executable to use based on your operating system and any other arguments or environmental configuration.

FAQ

Chrome opens to a blank page?

You may have some issues if your version of Chrome has recently updated and it and/or your OS hasn't be restarted. Quick fix here is to just try restarting Chrome and/or restarting your machine. This was identified in the opn project.

Do I need to install a Chrome Extension?

rawkit will automatically launch a splash page asking you to install a corresponding Chrome Extension the first time you run it. If you don't want to install the extension (not recommended, as the extension comes with some nice-to-have behaviors) AND are using a Mac, you can install chrome-cli to get around this. rawkit will automatically detect if chrome-cli exists on your machine and use that to open/launch chrome once it's installed.

$ brew install chrome-cli

Note: Unfortunately, opening internal Chrome links, externally, is not possible without an aid at the moment (ie. urls that contain chrome:// or chrome-devtools:// in this case). This is most likely a security feature. That said, you can use a Chrome Extension as a proxy to make this work. Check out the RESEARCH.md for more information.

You canā€™t perform that action at this time.