Show More
Commit Description:
change to encrypted cookies
Commit Description:
change to encrypted cookies
References:
File last commit:
Show/Diff file:
Action:
node_modules/convert-source-map/README.md
| 125 lines
| 4.4 KiB
| text/x-minidsrc
| MarkdownLexer
|
r789 | # convert-source-map [](http://travis-ci.org/thlorenz/convert-source-map) | |||
<a href="https://www.patreon.com/bePatron?u=8663953"><img alt="become a patron" src="https://c5.patreon.com/external/logo/become_a_patron_button.png" height="35px"></a> | ||||
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. | ||||
[](https://bitdeli.com/free "Bitdeli Badge") | ||||