Why inline source maps?

Question

Today I learned that it is possible to include source maps directly into your minified JavaScript file instead of having them in a separate example.min.map file. I wonder: why would anybody want to do something like that?

The benefit of having source maps is clear to me: one can for example debug errors with the original, non-compressed source files while running the minified files. The benefit of minimization is also clear: the size of source files is greatly reduced, making it quicker for browsers to download.

So why on Earth I would want to include the source maps into the minified file, given that the maps have size even greater than the minified code itself?

Maybe the .map extension is unknown and throws errors or problems for the administrators of machines that execute .exe and .dll files? — umeboshi, Dec 27 '14 at 21:02
I also learned that today.... after spending an hour trying to figure out why there weren't any and then discovering they already existed embedded into the .js file... — Simon_Weaver, Nov 18 '16 at 04:54

score 42 · Accepted Answer · answered Dec 30 '14 at 21:35

I searched around and the only reason I could see that people inline source maps is for use in development. Inlined source maps should not be used in production.

The rational for inlining the source maps with your minified files is that the browser is parsing the exact same JavaScript in development and production. Some minifiers like Closure Compiler do more than 'just' minify the code. Using the advanced options it can also do things like: dead code removal, function inlining, or aggressive variable renaming. This makes the minified code (potentially) functionally different than the source file.

This could still be done by referencing external source map files of course, but some people seem to prefer inlining for their build process.

Found an article today that dissects sourcemaps options (for webpack, primarily) pretty thoroughly. Good additional reading to back up this answer: https://survivejs.com/webpack/building/source-maps/ — ericsoco, Nov 05 '18 at 18:55
I wonder if there's a use-case for run-time code-generation as well? (would the browser accept an inline source-map provided as argument to `new Function()`?) — mindplay.dk, Dec 24 '18 at 09:55

Tim · Answer 2 · 2017-05-31T10:40:27.420

26

If you are remote debugging Chrome on an android device, the Chrome debugger cannot just access any file it wants on the device and that includes separate map files. If you include them inline you don't have this issue.

edited May 31 '17 at 10:40

answered Oct 05 '16 at 15:46

Tim

6,485
2
42
81

True, but what about the performance hit once your files become double the size? – Remi Feb 01 '18 at 10:15
5

You would obviously only do this in development – Tim Feb 01 '18 at 16:32
I disagree. If you have a DTAP setup you would also have the minified version accompanied by a sourcemap on Test and Acceptance. And even on Production to allow debugging on that environment. In development, you don't have to work with a minified version persé. Package managers allow for a separate file for sourcemaps which you can send along so you will not have to include it in the initial load to prevent a performance hit. – Remi Feb 01 '18 at 19:44
1

Similarly, Chrome extensions [can't currently access the source maps](https://stackoverflow.com/a/62270410/263900) so for development purposes it is necessary to inline them within the minified file. – doub1ejack Mar 24 '21 at 19:17

score 12 · Answer 3 · answered May 24 '15 at 18:18

12

JS bundling tools like Browserify or Webpack will bundle all your .js files input one or several bundles, even in developing mode. So in this case, adding inline source map to generated bundles is the easiest way to help debugging without bringing extra files.

answered May 24 '15 at 18:18

jasonslyvia

2,401
1
21
33

wonderful. I will try that. you just might've resolved my question too. http://stackoverflow.com/questions/40199998/how-to-generate-custom-source-map-with-custom-webpack-loader – guy mograbi Oct 23 '16 at 07:51

score 3 · Answer 4 · edited May 23 '17 at 12:18

In some situations you might want to include inline sourcemaps into evaluated code. E.g you have a coffeescript input field and you want to enable debbuging the code in coffeescript. There is a stackoverflow question about source maps in evaluated code:

Getting source maps working with evaluated code

You could include @sourceURL in your comments to specify a URL of your eval code and load a map file (see page 8 of SourceMap Spec 3). But it is not always possible to write files to some location.

score 1 · Answer 5 · answered Jul 12 '16 at 18:01

1

cheap-module-source-map is much better for a production build.

inline-source-map is used to make quick and dirty builds when testing

answered Jul 12 '16 at 18:01

Carl

11
1

Why inline source maps?

5 Answers5

Linked