wallet-core/node_modules/merge-source-map/README.md

91 lines
2.1 KiB
Markdown
Raw Normal View History

2017-05-28 00:38:50 +02:00
# merge-source-map
[![npm-version](https://img.shields.io/npm/v/merge-source-map.svg?style=flat-square)](https://npmjs.org/package/merge-source-map)
[![travis-ci](https://img.shields.io/travis/keik/merge-source-map.svg?style=flat-square)](https://travis-ci.org/keik/merge-source-map)
[![Coverage Status](https://img.shields.io/coveralls/keik/merge-source-map.svg?style=flat-square)](https://coveralls.io/github/keik/merge-source-map)
Merge old source map and new source map in multi-transform flow
# API
```javascript
var merge = require('merge-source-map')
```
## `merge(oldMap, newMap)`
Merge old source map and new source map and return merged.
If old or new source map value is falsy, return another one as it is.
<dl>
<dt>
<code>oldMap</code> : <code>object|undefined</code>
</dt>
<dd>
old source map object
</dd>
<dt>
<code>newmap</code> : <code>object|undefined</code>
</dt>
<dd>
new source map object
</dd>
</dl>
# Example
```javascript
var esprima = require('esprima'),
estraverse = require('estraverse'),
escodegen = require('escodegen'),
convert = require('convert-source-map'),
merge = require('merge-source-map')
const CODE = 'a = 1',
FILEPATH = 'a.js'
// create AST of original code
var ast = esprima.parse(CODE, {sourceType: 'module', loc: true})
// transform AST of original code
estraverse.replace(ast, {
enter: function(node, parent) { /* change AST */ },
leave: function(node, parent) { /* change AST */ }
})
// generate code and source map from transformed AST
var gen = escodegen.generate(ast, {
sourceMap: FILEPATH,
sourceMapWithCode: true,
sourceContent: CODE
})
// merge old source map and new source map
var oldMap = convert.fromSource(CODE) && convert.fromSource(CODE).toObject(),
newMap = JSON.parse(gen.map.toString()),
mergedMap = merge(oldMap, newMap),
mapComment = convert.fromObject(mergedMap).toComment()
// attach merge source map to transformed code
var transformed = gen.code + '\n' + mapComment
console.log(transformed);
```
# Test
```
% npm install
% npm test
```
# License
MIT (c) keik