Why does my debugger stop visually at the wrong line?

It is difficult to say for sure, but it seems that the issue that you are experiencing is related to a bug that causes Meteor to generate incorrect source maps.

source maps

This is not your browser's "fault". It simply displays the code and the position that is delivered to it by the source maps in your project.

The app.js file and the source map (app.js.map) are generated by the Meteor build process and are served from the .meteor/local/build/programs/web.browser/app directory.

The .map file is responsible of telling the browser how to display the original source, and which segments in the generated app.js file are mapped to which segments in the original source code.

A great explanation about the technical aspects of source maps can be found here.

You can visualize your source maps online and see what maps where using this tool (choose custom... and drag/drop both .js and .map files.

the suspected bug

As a part of the build process, Meteor uses the babel-compiler Meteor package. At some point, a bug caused invalid maps to be produced after babel transformations.

The bug is currently tracked on GitHub and the Meteor folks seem to be closing in on the cause.

what can you do?

At the moment, there is no quick and easy fix.

You can either:

  • Watch the bug thread and wait for it to be resolved and debug without source maps for now (probably best, if the bug will be fixed soon).
  • Hack away with local clones of the relevant Meteor packages (could work, I haven't dug into the dependency issues and don't really recommend it, but here's a way of doing it).
  • Run Meteor from a git checkout in a known good state until a fix is released.

The last option is what @hwilson did in order to begin pinpointing the bug via a git bisect.

You can refer to the Meteor developer document for detailed information regarding the method of running the meteor tool from checkout, but the gist of the things is as follows:

First, make sure that your code, including the .meteor/versions and .meteor/packages are checked out into source control, as you will likely need to mess them up temporarily and will want to restore them once the bug is fixed.

  1. git clone --recursive https://github.com/meteor/meteor.git to a directory of your choosing (e.g, /home/yourname/src/remote.
  2. cd meteor.
  3. git checkout 25a89b5 to get the last known good commit.
  4. git submodule update --init --recursive to make sure everything is still golden after the checkout.
  5. ./meteor --help to have the checked out version start
  6. In your project, remove the version info from the .meteor/packages file, as they will likely be incompatible with the ones offered by your checkout.
  7. In your project dir, run /home/yourname/src/remote/meteor/meteor run.

This will run the checked out Meteor version. You may need to do a meteor reset (warning: this clears the local mongo database) or at least clean some of .meteor/local, (e.g, the source maps) for this to work, but this may be unnecessary.

This is quite a lot of effort for a bug which I assume will be resolved in the near future, but I decided to include this info partly in order to be used as documentation for future sourcemap-related issues.


It is three years too late, but if somebody steel has this problem. The problem is in the different interpretation of line separators by IDE and compiler, which generates .map files. For example on the windows in the WebStorm and Angular-Project - the TypeScript compiler ignores line separators, if they are Unix-Style (only LF). In this case if code formatter transforms too long line to couple of shorter lines and splits these lines by only LF, then in .map file this originally single line will be interpreted as single line, but WebStorm displays by LF separated lines as different lines.

Solution - change line separator to CR+LF and problem will be solved!

P.S. I thin this is a bug in TypeScript compiler


It's hard to say for certain. On a cursory google search it would appear you're not the only one seeing this. As @MasterAM mentioned, it's probably because of source maps from transpilation. I don't think you can do a whole lot about it, but you can try clearing the browser and IDE caches which appears to have worked for some.

Javascript Stops at a line without a breakpoint in remote debug mode

Clearing Webstorm's cache