JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 33129
  • Score
    100M100P100Q141489F
  • License

Externalizes the source map found inside a stream to an external `.js.map` file

Package Exports

  • exorcist

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (exorcist) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

exorcist build status

Externalizes the source map found inside a stream to an external .js.map file

var browserify = require('browserify')
  , path       = require('path')
  , fs         = require('fs')
  , exorcist   = require('exorcist')
  , mapfile    = path.join(__dirname, 'bundle.js.map')

browserify()
  .require(require.resolve('./main'), { entry: true })
  .bundle({ debug: true })
  .pipe(exorcist(mapfile))
  .pipe(fs.createWriteStream(path.join(__dirname, 'bundle.js'), 'utf8'))

command line example

browserify main.js --debug | exorcist bundle.js.map > bundle.js

Table of Contents generated with DocToc

Usage

exorcist <mapfile> <exorcist-options>

  Externalizes the source map of a file that is streamed into it by pointing it's source map url to the <mapfile>.
  The original source map is written to the <mapfile> as json.
  
OPTIONS:

  --root -r   The path to the original source to be included in the source map.   (default '')
  --url  -u   The path to the source map to which to point the sourceMappingURL.  (default <mapfile>)

EXAMPLE:

  Bundle main.js with browserify into bundle.js and externalize the map to bundle.js.map

    browserify main.js --debug | exorcist bundle.js.map > bundle.js

Installation

npm install exorcist

API

exorcist(file, url, root) → {TransformStream}

Transforms the incoming stream of code by removing the inlined source map and writing it to an external map file. Additionally it adds a source map url that points to the extracted map file.

Events (other than all stream events like error)

  • missing-map emitted if no map was found in the stream (the src still is piped through in this case, but no map file is written)
Parameters:
Name Type Argument Description
file String

full path to the map file to which to write the extracted source map
url String <optional>

allows overriding the url at which the map file is found (default: name of map file)
root String <optional>

allows adjusting the source maps sourceRoot field (default: '')
Source:
Returns:

transform stream into which to pipe the code containing the source map

Type
TransformStream

generated with docme

Integration with other tools

License

MIT