How can I debug my Meteor app using the WebStorm IDE?

by

WebStorm is the only IDE with native support for debugging Meteor server code – check this video. Even on Windows, debugging is very simple:

WebStorm 9+

Go to Run –> Debug –> Edit configurations… , click the plus sign, click “Meteor”. You can add environment variable like ROOT_URL if you need to.

WebStorm older than 9

This answer is kept only for historical purposes. You should upgrade WebStorm.

On older WebStorms, you used to have to create a Node.js debugging configuration.

  • on the server, export the environment variable NODE_OPTIONS=--debug=47977. For instance,

    NODE_OPTIONS=--debug=47977 meteor  # Linux/Mac
set NODE_OPTIONS=--debug=47977 & meteor`  # Windows

  • create a WebStorm/PhpStorm Run/Debug configuration using the port above (47977) and the server host. Leave 127.0.0.1 if you’re debugging locally.

Run -> Run/Debug confioguration

  • in WebStorm, Run -> Debug <myapp>, or press Shift+F9. Make sure that you see “Connected to <your host> in the Debug panel

Now you can set breakpoints, have access to local variables etc.

For client debugging, just use the Chrome debugger, or Firebug.

Troubleshooting

  • Process disconnected unexpectedly – this happens when meteor restarts automatically because of lack of specific support for Meteor. Just Run -> Debug <myapp>, or press Shift+F9 again.

  • you can’t connect to the server – make sure the firewall rules allow incoming connections to whatever port you chose for the Node.js debugger (47977 here).

More Related Contents:

  1. How do I debug “Error: spawn ENOENT” on node.js?
  2. Error message “error:0308010C:digital envelope routines::unsupported”
  3. How to debug a socket hang up error in NodeJS?
  4. 2013 Meteor NPM Packages
  5. Meteor Subscribe doesn’t update sort order of collection
  6. How to debug Node.JS child forked process?
  7. What’s going on with Meteor and Fibers/bindEnvironment()?
  8. Meteor WebSocket handshake error 400 with nginx
  9. Meteor Node Process CPU Usage Nears 100%
  10. Express.js req.body undefined
  11. How do I install a module globally using npm?
  12. How to use private Github repo as npm dependency
  13. How to get all registered routes in Express?
  14. Node cannot find module “fs” when using webpack
  15. Using Environment Variables with Vue.js
  16. How to NodeJS require inside TypeScript file?
  17. Error: No default engine was specified and no extension was provided
  18. node.js http.get hangs after 5 requests to remote site
  19. HTTP to HTTPS redirection on App Engine Flexible
  20. How to get synchronous readline, or “simulate” it using async, in nodejs?
  21. Node.js setting up environment specific configs to be used with everyauth
  22. Google OAuth using domain wide delegation and service account
  23. Node.js spawn child process and get terminal output live
  24. jwt.io says Signature Verified even when key is not provided
  25. Destroy cookie NodeJs
  26. Node.js 17.0.1 Gatsby error – “digital envelope routines::unsupported … ERR_OSSL_EVP_UNSUPPORTED” [duplicate]
  27. How to clean node_modules folder of packages that are not in package.json?
  28. How to override a nested npm sub-dependency with a different package altogether (not just different package version number)?
  29. nodejs mongodb object id to string
  30. How to resolve a Socket.io 404 (Not Found) error?

Leave a Comment