Overview

Tools for working with sourceMappingURL comments.

1var sourceMappingURL = require("source-map-url")
2
3var code = [
4  "!function(){...}();",
5  "/*# sourceMappingURL=foo.js.map */"
6].join("\n")
7
8sourceMappingURL.existsIn(code)
9// true
10
11sourceMappingURL.getFrom(code)
12// foo.js.map
13
14code = sourceMappingURL.insertBefore(code, "// License: MIT\n")
15// !function(){...}();
16// // License: MIT
17// /*# sourceMappingURL=foo.js.map */
18
19code = sourceMappingURL.removeFrom(code)
20// !function(){...}();
21// // License: MIT
22
23sourceMappingURL.existsIn(code)
24// false
25
26sourceMappingURL.getFrom(code)
27// null
28
29code += "//# sourceMappingURL=/other/file.js.map"
30// !function(){...}();
31// // License: MIT
32// //# sourceMappingURL=/other/file.js.map

Installation

• npm install source-map-url
• bower install source-map-url
• component install lydell/source-map-url

Works with CommonJS, AMD and browser globals, through UMD.

Usage

sourceMappingURL.getFrom(code)

Returns the url of the sourceMappingURL comment in code. Returns null if there is no such comment.

sourceMappingURL.existsIn(code)

Returns true if there is a sourceMappingURL comment in code, or false otherwise.

sourceMappingURL.removeFrom(code)

Removes the sourceMappingURL comment in code. Does nothing if there is no such comment. Returns the updated code.

sourceMappingURL.insertBefore(code, string)

Inserts string before the sourceMappingURL comment in code. Appends string to code if there is no such comment.

Lets you append something to a file without worrying about burying the sourceMappingURL comment (by keeping it at the end of the file).

sourceMappingURL.regex

The regex that is used to match sourceMappingURL comments. It matches both // and /**/ comments, thus supporting both JavaScript and CSS.

Tests

Start by running npm test, which lints the code and runs the test suite in Node.js.

To run the tests in a browser, run testling (npm install -g testling) or testling -u.

License

The X11 (“MIT”) License.