From:  Brian Slesinsky <skybrian@google.com>
Date:  18 Mar 2014 07:41:15 Hong Kong Time
Newsgroup:  news.mozilla.org/mozilla.dev.js-sourcemap
Subject:  

better document the "names" field in Source Maps

NNTP-Posting-Host:  63.245.216.66

(Sending this to the list since I can't comment directly on the document.)

Re:
https://docs.google.com/a/google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit#

A comment on this line:
  Line 7: A list of symbol names used by the “mappings” entry.

I think the spec should explain a bit more about how this is typically
used. Despite doing a fair amount of work with sourcemaps, I was unclear on
this until recently.

As far as I know no debugger uses the "names" field, but the intention is
to deobfuscate stack traces. That is, when a JavaScript exception occurs or
a debugger stops at a breakpoint, we can treat the stack trace as a list of
positions in JavaScript files. For each position, the "name" is the
deobfuscated function name that should appear in the stack trace. (Or more
generally, it is whatever string would most usefully appear in the function
name position when displaying a stack frame in the debugger.)

- Brian