Buckets:
| # convert-source-map [![Build Status][ci-image]][ci-url] | |
| 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQvZm9vLm1pbi5qcyIsInNvdXJjZXMiOlsic3JjL2Zvby5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSIsInNvdXJjZVJvb3QiOiIvIn0=') | |
| .toJSON(); | |
| var modified = convert | |
| .fromComment('//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQvZm9vLm1pbi5qcyIsInNvdXJjZXMiOlsic3JjL2Zvby5qcyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSIsInNvdXJjZVJvb3QiOiIvIn0=') | |
| .setProperty('sources', [ 'SRC/FOO.JS' ]) | |
| .toJSON(); | |
| console.log(json); | |
| console.log(modified); | |
| ``` | |
| ```json | |
| {"version":3,"file":"build/foo.min.js","sources":["src/foo.js"],"names":[],"mappings":"AAAA","sourceRoot":"/"} | |
| {"version":3,"file":"build/foo.min.js","sources":["SRC/FOO.JS"],"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([options]) | |
| Converts source map to an inline comment that can be appended to the source-file. | |
| By default, the comment is formatted like: `//# sourceMappingURL=...`, which you would | |
| normally see in a JS source file. | |
| When `options.multiline == true`, the comment is formatted like: `/*# sourceMappingURL=... */`, which you would find in a CSS source file. | |
| ### 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 | |
| Provides __a fresh__ RegExp each time it is accessed. Can be used to find source map comments. | |
| ### mapFileCommentRegex | |
| Provides __a fresh__ RegExp each time it is accessed. Can be used to find source map comments pointing to map files. | |
| ### generateMapFileComment(file, [options]) | |
| Returns a comment that links to an external source map via `file`. | |
| By default, the comment is formatted like: `//# sourceMappingURL=...`, which you would normally see in a JS source file. | |
| When `options.multiline == true`, the comment is formatted like: `/*# sourceMappingURL=... */`, which you would find in a CSS source file. | |
| [ci-url]: https://github.com/thlorenz/convert-source-map/actions?query=workflow:ci | |
| [ci-image]: https://img.shields.io/github/workflow/status/thlorenz/convert-source-map/CI?style=flat-square | |
Xet Storage Details
- Size:
- 4.25 kB
- Xet hash:
- 9dc5fe42231418ad647a3f87db9d3d963294b96943579102f126af989a1cb3d6
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.