thlorenz/exorcist — 331★ on GitHub (JavaScript). Externalizes the source map found inside a stream to an external .js.map file
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Externalizes the source map found inside a stream to an external .map file or stream.
Works with both JavaScript and CSS input streams.
var browserify = require('browserify')
, path = require('path')
, fs = require('fs')
, exorcist = require('exorcist')
, mapfile = path.join(__dirname, 'bundle.js.map')
// from a file, to a file, and send source map to its own file
browserify({debug: true})
.require(require.resolve('./main'), { entry: true })
.bundle()
.pipe(exorcist(mapfile))
.pipe(fs.createWriteStream(path.join(__dirname, 'bundle.js'), 'utf8'))
// from a stream, to a stream, and send source map to a stream
browserify([readableSourceStream], browserifyOptions)
.bundle()
.pipe(exorcist(targetSourceMapStream, '/url/path/to/replace/source/comment/with/bundle.js'))
.pipe(writableTargetStream)
exorcist map_file [options]
Externalizes the source map of the file streamed in.
The source map is written as JSON to map_file, and the original file is streamed out with its
sourceMappingURL set to the path of map_file (or to the value of the --url option).
OPTIONS:
--base -b Base path for calculating relative source paths.
(default: use absolute paths)
--root -r Root URL for loading relative source paths.
Set as sourceRoot in the source map.
(default: '')
--url -u Full URL to source map.
Set as sourceMappingURL in the output stream.
(default: map_file)
--error-on-missing -e Abort with error if no map is found in the stream.
(default: warn but still pipe through source)
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
Externalizes the source map of the file streamed in.
The source map is written as JSON to file, and the original file is streamed out with its
sourceMappingURL set to the path of file (or to the value of url).
Events (in addition to stream events)
missing-map emitted if no map was found in the stream and errorOnMissing is falsey
(the src is still piped through in this case, but no map file is written)
Parameters:
Name
Type
Argument
Description
input
String / Object
full path to the map file to which to write the extracted source map or a writable stream
url
String
<optional>
full URL to the map file, set as sourceMappingURL in the streaming output (default: file)
root
String
<optional>
root URL for loading relative source paths, set as sourceRoot in the source map (default: '')
base
String
<optional>
base path for calculating relative source paths (default: use absolute paths)
errorOnMissing
Boolean
<optional>
when truthy, causes 'error' to be emitted instead of 'missing-map' if no map was found in the stream (default: falsey)
Source:
index.js
,
lineno 33
Returns:
transform stream into which to pipe the code containing the source map
Yes — thlorenz/exorcist ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/thlorenz/exorcist.
What is thlorenz/exorcist?
thlorenz/exorcist (thlorenz/exorcist) is a JavaScript project on GitHub. From the project's own README: Externalizes the source map found inside a stream to an external .js.map file
Where do I read more about thlorenz/exorcist?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/thlorenz/exorcist is the definitive source.
Read full README in the tab above.
Still deciding about exorcist?
One click hands the question to an AI along with this page — see what it says about exorcist.