Repository files navigation

• NAME
• INSTALL
• SYNOPSIS
• DESCRIPTION
• DEVELOPMENT
  • NPM Scripts
• COMPATIBILITY
• SEE ALSO
• VERSION
• AUTHOR
• COPYRIGHT AND LICENSE

babel-plugin-source-map-support - a Babel plugin which automatically makes stack traces source-map aware

$ npm install source-map-support --save$ npm install babel-plugin-source-map-support --save-dev

$ cat test.js

importfoofrom'foo';importbarfrom'bar';foo(bar);

$ babel --plugins source-map-support test.js

import'source-map-support/register';importfoofrom'foo';importbarfrom'bar';foo(bar);

This is aBabelplugin which prepends thefollowing statement to source files:

import'source-map-support/register';

In conjunction with thesource-map-support module,which must be installed separately, this statement hooks into the v8stack-trace API to translate call sites in the transpiled code back to theircorresponding locations in the original code.

Note: this only works in environments which support the v8 stack-trace API(e.g. Node.js and Chrome), though it's harmless in other environments.

The source-map-support module only needs to be registered in the top-levelfile(s) of an application, but it no-ops if it has already been loaded, sothere's no harm in registering it in every file.

You probably don't want to use this plugin when compiling code for the webbecause you probably don't want to bundle source-maps and thesource-map-support module in minified code. An easy way to limit the plugin'sscope to development/test builds is to use Babel'senv option, e.g.:

{env:{development:{sourceMaps:'inline',plugins:['source-map-support', ...]}},presets:[ ...]}

Note that source-maps don't need to be inlined in each file. They can beexternalised by using the{ sourceMaps: true } option. This adds a link tothe bottom of each file which points to its generated source-map, e.g.:

{env:{development:{sourceMaps:true,plugins:['source-map-support', ...]}},}

// index.js footer://# sourceMappingURL=index.js.map

• Babel >= 7
• Maintained Node.js versions

• babel
• source-map-support

2.2.0

chocolateboy

Copyright © 2015-2022 by chocolateboy.

This module is free software; you can redistribute it and/or modify it under theterms of theArtistic License 2.0.