114 lines
3.6 KiB
Markdown
114 lines
3.6 KiB
Markdown
# convert-source-map [](http://travis-ci.org/thlorenz/convert-source-map)
|
|
|
|
[](https://nodei.co/npm/convert-source-map/)
|
|
|
|
Converts a source-map from/to different formats and allows adding/changing properties.
|
|
|
|
```js
|
|
var convert = require('convert-source-map');
|
|
|
|
var json = convert
|
|
.fromComment('//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9vLmpzIiwic291cmNlcyI6WyJjb25zb2xlLmxvZyhcImhpXCIpOyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSIsInNvdXJjZVJvb3QiOiIvIn0=')
|
|
.toJSON();
|
|
|
|
var modified = convert
|
|
.fromComment('//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9vLmpzIiwic291cmNlcyI6WyJjb25zb2xlLmxvZyhcImhpXCIpOyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSIsInNvdXJjZVJvb3QiOiIvIn0=')
|
|
.setProperty('sources', [ 'CONSOLE.LOG("HI");' ])
|
|
.toJSON();
|
|
|
|
console.log(json);
|
|
console.log(modified);
|
|
```
|
|
|
|
```json
|
|
{"version":3,"file":"foo.js","sources":["console.log(\"hi\");"],"names":[],"mappings":"AAAA","sourceRoot":"/"}
|
|
{"version":3,"file":"foo.js","sources":["CONSOLE.LOG(\"HI\");"],"names":[],"mappings":"AAAA","sourceRoot":"/"}
|
|
```
|
|
|
|
## API
|
|
|
|
### fromObject(obj)
|
|
|
|
Returns source map converter from given object.
|
|
|
|
### fromJSON(json)
|
|
|
|
Returns source map converter from given json string.
|
|
|
|
### fromBase64(base64)
|
|
|
|
Returns source map converter from given base64 encoded json string.
|
|
|
|
### fromComment(comment)
|
|
|
|
Returns source map converter from given base64 encoded json string prefixed with `//# sourceMappingURL=...`.
|
|
|
|
### fromMapFileComment(comment, mapFileDir)
|
|
|
|
Returns source map converter from given `filename` by parsing `//# sourceMappingURL=filename`.
|
|
|
|
`filename` must point to a file that is found inside the `mapFileDir`. Most tools store this file right next to the
|
|
generated file, i.e. the one containing the source map.
|
|
|
|
### fromSource(source)
|
|
|
|
Finds last sourcemap comment in file and returns source map converter or returns null if no source map comment was
|
|
found.
|
|
|
|
### fromMapFileSource(source, mapFileDir)
|
|
|
|
Finds last sourcemap comment in file and returns source map converter or returns null if no source map comment was
|
|
found.
|
|
|
|
The sourcemap will be read from the map file found by parsing `# sourceMappingURL=file` comment. For more info see
|
|
fromMapFileComment.
|
|
|
|
### toObject()
|
|
|
|
Returns a copy of the underlying source map.
|
|
|
|
### toJSON([space])
|
|
|
|
Converts source map to json string. If `space` is given (optional), this will be passed to
|
|
[JSON.stringify](https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/JSON/stringify) when the
|
|
JSON string is generated.
|
|
|
|
### toBase64()
|
|
|
|
Converts source map to base64 encoded json string.
|
|
|
|
### toComment()
|
|
|
|
Converts source map to base64 encoded json string prefixed with `//# sourceMappingURL=...`.
|
|
|
|
### addProperty(key, value)
|
|
|
|
Adds given property to the source map. Throws an error if property already exists.
|
|
|
|
### setProperty(key, value)
|
|
|
|
Sets given property to the source map. If property doesn't exist it is added, otherwise its value is updated.
|
|
|
|
### getProperty(key)
|
|
|
|
Gets given property of the source map.
|
|
|
|
### removeComments(src)
|
|
|
|
Returns `src` with all source map comments removed
|
|
|
|
### removeMapFileComments(src)
|
|
|
|
Returns `src` with all source map comments pointing to map files removed.
|
|
|
|
### commentRegex
|
|
|
|
Returns the regex used to find source map comments.
|
|
|
|
### mapFileCommentRegex
|
|
|
|
Returns the regex used to find source map comments pointing to map files.
|
|
|
|
|
|
[](https://bitdeli.com/free "Bitdeli Badge")
|
|
|