Name: sourcemapped-stacktrace
Owner: KADIRA
Description: apply sourcemaps to js stack traces
Forked from: novocaine/sourcemapped-stacktrace
Created: 2016-05-17 01:40:16.0
Updated: 2016-05-17 01:40:17.0
Pushed: 2016-04-30 10:22:10.0
Homepage: null
Size: 46
Language: JavaScript
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This is a simple module for applying source maps to JS stack traces in the browser.
You have Error.stack() in JS (maybe you're logging a trace, or you're looking at traces in Jasmine or Mocha), and you need to apply a sourcemap so you can understand whats happening because you're using some fancy compiled-to-js thing like coffeescript or traceur. Unfortunately, the browser only applies sourcemaps when the trace is viewed in its console, not to the underlying stack object, so you're out of luck.
http://novocaine.github.io/sourcemapped-stacktrace-demo/public_html/smst.html
install sourcemapped-stacktrace
The npm bundle contains dist/sourcemapped-stacktrace.js, if that's what you're after. The built product is not held in this repo.
Include sourcemapped-stacktrace.js into your page using either an AMD module loader or a plain old script include. As an AMD module it exposes the method 'mapStackTrace'. If an AMD loader is not found this function will be set on window.sourceMappedStackTrace.mapStackTrace.
Re-map entries in a stacktrace using sourcemaps if available.
Arguments:
stack: Array of strings from the browser's stack representation. Currently only Chrome and Firefox format is supported.
done: Callback invoked with the transformed stacktrace (an Array of Strings) passed as the first argument
{
break something
rk();
tch (e) {
pass e.stack to window.mapStackTrace
ndow.mapStackTrace(e.stack, function(mappedStack) {
// do what you want with mappedStack here
console.log(mappedStack.join("\n"));
;
Several modern browsers support sourcemaps when viewing stack traces from errors in their native console, but as of the time of writing there is no support for applying a sourcemap to the (highly non-standardised) Error.prototype.stack. Error.prototype.stack can be used for logging errors and for displaying errors in test frameworks, and it is not very convenient to have unmapped traces in either of those use cases.
This module fetches all the scripts referenced by the stack trace, determines whether they have an applicable sourcemap, fetches the sourcemap from the server, then uses the Mozilla source-map library to do the mapping. Browsers that support sourcemaps don't offer a standardised sourcemap API, so we have to do all that work ourselves.
The nice part about doing it ourselves is that the library could be extended to work in browsers that don't support sourcemaps, which could be good for logging and debugging problems. Currently, only Chrome and Firefox are supported, but it would be easy to support those formats by ripping off stacktrace.js.