typesetting/pitfall/pdfkit/node_modules/exorcist

exorcist

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
• Installation
• API
• Integration with other tools
• License

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:

• index.js , lineno 27

Returns:

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

Type

TransformStream

generated with docme

Integration with other tools

• using exorcist with gulp

License

MIT