Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chocolateboy/babel-plugin-source-map-support
A Babel plugin which automatically makes stack traces source-map aware
https://github.com/chocolateboy/babel-plugin-source-map-support
babel babel-plugin node-package npm-module npm-package plugin source-map source-maps sourcemap sourcemaps
Last synced: 5 days ago
JSON representation
A Babel plugin which automatically makes stack traces source-map aware
- Host: GitHub
- URL: https://github.com/chocolateboy/babel-plugin-source-map-support
- Owner: chocolateboy
- License: artistic-2.0
- Created: 2015-09-16T19:32:37.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-01-08T22:15:51.000Z (almost 2 years ago)
- Last Synced: 2024-10-16T03:41:29.504Z (21 days ago)
- Topics: babel, babel-plugin, node-package, npm-module, npm-package, plugin, source-map, source-maps, sourcemap, sourcemaps
- Language: JavaScript
- Homepage:
- Size: 539 KB
- Stars: 45
- Watchers: 4
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/chocolateboy/babel-plugin-source-map-support/actions?query=workflow%3Atest)
[](https://www.npmjs.org/package/babel-plugin-source-map-support)
- [NAME](#name)
- [INSTALL](#install)
- [SYNOPSIS](#synopsis)
- [DESCRIPTION](#description)
- [DEVELOPMENT](#development)
- [NPM Scripts](#npm-scripts)
- [COMPATIBILITY](#compatibility)
- [SEE ALSO](#see-also)
- [VERSION](#version)
- [AUTHOR](#author)
- [COPYRIGHT AND LICENSE](#copyright-and-license)
# NAME
babel-plugin-source-map-support - a Babel plugin which automatically makes stack traces source-map aware
# INSTALL
$ npm install source-map-support --save
$ npm install babel-plugin-source-map-support --save-dev
# SYNOPSIS
`$ cat test.js`
```javascript
import foo from 'foo';
import bar from 'bar';
foo(bar);
```
`$ babel --plugins source-map-support test.js`
```javascript
import 'source-map-support/register';
import foo from 'foo';
import bar from 'bar';
foo(bar);
```
# DESCRIPTION
This is a [Babel](https://babeljs.io/)
[plugin](https://babeljs.io/docs/advanced/plugins/) which prepends the
following statement to source files:
```javascript
import 'source-map-support/register';
```
In conjunction with the
[source-map-support](https://www.npmjs.com/package/source-map-support) module,
**which must be installed separately**, this statement hooks into the v8
stack-trace API to translate call sites in the transpiled code back to their
corresponding 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-level
file(s) of an application, but it no-ops if it has already been loaded, so
there's no harm in registering it in every file.
You probably don't want to use this plugin when compiling code for the web
because you probably don't want to bundle source-maps and the
source-map-support module in minified code. An easy way to limit the plugin's
scope to development/test builds is to use Babel's
[`env` option](https://babeljs.io/docs/en/options#env), e.g.:
```javascript
{
env: {
development: {
sourceMaps: 'inline',
plugins: ['source-map-support', ...]
}
},
presets: [ ... ]
}
```
Note that source-maps don't need to be inlined in each file. They can be
externalised by using the `{ sourceMaps: true }` option. This adds a link to
the bottom of each file which points to its generated source-map, e.g.:
```javascript
{
env: {
development: {
sourceMaps: true,
plugins: ['source-map-support', ...]
}
},
}
```
```javascript
// index.js footer:
//# sourceMappingURL=index.js.map
```
# DEVELOPMENT
## NPM Scripts
The following NPM scripts are available:
- build - compile the plugin and save it to the `dist` directory
- build:doc - generate the README's TOC (table of contents)
- clean - remove the `dist` directory and other build artifacts
- rebuild - clean the build artifacts and recompile the code
- test - rebuild the plugin and run the test suite
- test:debug - run the `test` script in debug mode, which dumps each transformed test case
- test:prod - run the test suite in production mode
- test:run - run the test suite
# COMPATIBILITY
- Babel >= 7
- [Maintained Node.js versions](https://github.com/nodejs/Release#readme)
# SEE ALSO
- [babel](https://babeljs.io/)
- [source-map-support](https://www.npmjs.com/package/source-map-support)
# VERSION
2.2.0
# AUTHOR
[chocolateboy](mailto:[email protected])
# COPYRIGHT AND LICENSE
Copyright © 2015-2022 by chocolateboy.
This module is free software; you can redistribute it and/or modify it under the
terms of the [Artistic License 2.0](https://www.opensource.org/licenses/artistic-license-2.0.php).