The Bugsnag JavaScript library supports using source maps to reverse JavaScript minification. In order for this to work, Bugsnag needs access to the source map. You can either do this by hosting the source maps or by uploading them to Bugsnag.
Most modern minification tools support the generation of source maps, so it is easy to add this to your build process:
When generating source maps you normally have the option to include the source content within the source map or leave it in the external source files. If you leave it external Bugsnag will need access to those source files to display the context of the error (without it we will just display the source file and line number in the stacktrace).
Source maps can also be encoded directly into the javascript file rather than linking to a external file, known as inline source maps. This is sometimes used for development purposes or in certain bundling frameworks like Browserify. Bugsnag also supports source maps of this type.
If you host the source map Bugsnag can fetch it when an error is
received. To achieve this you can include the special sourceMappingURL
comment at the end of the JavaScript file or set the X-SourceMap
property in the header.
Most minification tools, including UglifyJS 2, will automatically add the
sourceMappingURL to your minified JavaScript files.
When generating source maps you’ll usually have the option to include the source content within the source map or leave it in the external source files. If you have not included the source content in the source map we will also attempt to fetch the source files based on the path specified in the source map.
If your server policy denies access to external IP addresses and websites, you will need to whitelist the IP addresses below. A whitelist provides access to designated IP addresses and sites that would otherwise be prevented by your security policy.
If you don’t want to host your source maps, you can upload them to Bugsnag using one of the following options:
Alternatively, you can interact with our upload API directly.
You can review a list of your uploaded maps, and delete any unneeded ones, within your dashboard: Project Settings -> Uploaded source maps.