source-list-map

API

Example

1var SourceListMap = require("source-list-map").SourceListMap;
2
3// Create a new map
4var map = new SourceListMap();
5
6// Add generated code that is map line to line to some soure
7map.add("Generated\ncode1\n", "source-code.js", "Orginal\nsource");
8
9// Add generated code that isn't mapped
10map.add("Generated\ncode2\n");
11
12// Get SourceMap and generated source
13map.toStringWithSourceMap({ file: "generated-code.js" });
14// {
15//   source: 'Generated\ncode1\nGenerated\ncode2\n',
16//   map: {
17//      version: 3,
18//      file: 'generated-code.js',
19//      sources: [ 'source-code.js' ],
20//      sourcesContent: [ 'Orginal\nsource' ],
21//      mappings: 'AAAA;AACA;;;'
22//    }
23// }
24
25// Convert existing SourceMap into SourceListMap
26// (Only the first mapping per line is preserved)
27var fromStringWithSourceMap = require("source-list-map").fromStringWithSourceMap;
28var map = fromStringWithSourceMap("Generated\ncode", { version: 3, ... });
29

new SourceListMap()

SourceListMap.prototype.add

1SourceListMap.prototype.add(generatedCode: string)
2SourceListMap.prototype.add(generatedCode: string, source: string, originalSource: string)
3SourceListMap.prototype.add(sourceListMap: SourceListMap)

Append some stuff.

SourceListMap.prototype.prepend

1SourceListMap.prototype.prepend(generatedCode: string)
2SourceListMap.prototype.prepend(generatedCode: string, source: string, originalSource: string)
3SourceListMap.prototype.prepend(sourceListMap: SourceListMap)

Prepend some stuff.

SourceListMap.prototype.toString()

Get generated code.

SourceListMap.prototype.toStringWithSourceMap

1SourceListMap.prototype.toStringWithSourceMap(options: object)

Get generated code and SourceMap. options can contains file property which defines the file property of the SourceMap.

SourceListMap.prototype.mapGeneratedCode

1SourceListMap.prototype.mapGeneratedCode(fn: function) : SourceListMap

Applies fn to each generated code block (per line). The returned value is set as new generated code. Returns a new SourceListMap.

Removing and adding lines is supported. The SourceMap complexity will increase when doing this.

Test

License

Copyright (c) 2017 JS Foundation

MIT (http://www.opensource.org/licenses/mit-license.php)