@jridgewell/source-map

Packages @jridgewell/trace-mapping and @jridgewell/gen-mapping into the familiar source-map API

This isn't the full API, but it's the core functionality. This wraps @jridgewell/trace-mapping and @jridgewell/gen-mapping implementations.

Installation

1npm install @jridgewell/source-map

Usage

TODO

SourceMapConsumer

1import { SourceMapConsumer } from '@jridgewell/source-map';
2const smc = new SourceMapConsumer({
3  version: 3,
4  names: ['foo'],
5  sources: ['input.js'],
6  mappings: 'AAAAA',
7});

SourceMapConsumer.fromSourceMap(mapGenerator[, mapUrl])

Transforms a SourceMapGenerator into a SourceMapConsumer.

1const smg = new SourceMapGenerator();
2
3const smc = SourceMapConsumer.fromSourceMap(map);
4smc.originalPositionFor({ line: 1, column: 0 });

SourceMapConsumer.prototype.originalPositionFor(generatedPosition)

1const smc = new SourceMapConsumer(map);
2smc.originalPositionFor({ line: 1, column: 0 });

SourceMapConsumer.prototype.mappings

1const smc = new SourceMapConsumer(map);
2smc.mappings; // AAAA

SourceMapConsumer.prototype.allGeneratedPositionsFor(originalPosition)

1const smc = new SourceMapConsumer(map);
2smc.allGeneratedpositionsfor({ line: 1, column: 5, source: "baz.ts" });
3// [
4//   { line: 2, column: 8 }
5// ]

SourceMapConsumer.prototype.eachMapping(callback[, context[, order]])

This implementation currently does not support the "order" parameter. This function can only iterate in Generated order.

1const smc = new SourceMapConsumer(map);
2smc.eachMapping((mapping) => {
3// { source: 'baz.ts',
4//   generatedLine: 4,
5//   generatedColumn: 5,
6//   originalLine: 4,
7//   originalColumn: 5,
8//   name: null }
9});

SourceMapConsumer.prototype.generatedPositionFor(originalPosition)

1const smc = new SourceMapConsumer(map);
2smc.generatedPositionFor({ line: 1, column: 5, source: "baz.ts" });
3// { line: 2, column: 8 }

SourceMapConsumer.prototype.hasContentsOfAllSources()

1const smc = new SourceMapConsumer(map);
2smc.hasContentsOfAllSources();
3// true

SourceMapConsumer.prototype.sourceContentFor(source[, returnNullOnMissing])

1const smc = new SourceMapConsumer(map);
2smc.generatedPositionFor("baz.ts");
3// "export default ..."

SourceMapConsumer.prototype.version

Returns the source map's version

SourceMapGenerator

1import { SourceMapGenerator } from '@jridgewell/source-map';
2const smg = new SourceMapGenerator({
3  file: 'output.js',
4  sourceRoot: 'https://example.com/',
5});

SourceMapGenerator.fromSourceMap(map)

Transform a SourceMapConsumer into a SourceMapGenerator.

1const smc = new SourceMapConsumer();
2const smg = SourceMapGenerator.fromSourceMap(smc);

SourceMapGenerator.prototype.applySourceMap(sourceMapConsumer[, sourceFile[, sourceMapPath]])

This method is not implemented yet

SourceMapGenerator.prototype.addMapping(mapping)

1const smg = new SourceMapGenerator();
2smg.addMapping({
3  generated: { line: 1, column: 0 },
4  source: 'input.js',
5  original: { line: 1, column: 0 },
6  name: 'foo',
7});

SourceMapGenerator.prototype.setSourceContent(sourceFile, sourceContent)

1const smg = new SourceMapGenerator();
2smg.setSourceContent('input.js', 'foobar');

SourceMapGenerator.prototype.toJSON()

1const smg = new SourceMapGenerator();
2smg.toJSON(); // { version: 3, names: [], sources: [], mappings: '' }

SourceMapGenerator.prototype.toString()

1const smg = new SourceMapGenerator();
2smg.toJSON(); // "{version:3,names:[],sources:[],mappings:''}"

SourceMapGenerator.prototype.toDecodedMap()

1const smg = new SourceMapGenerator();
2smg.toDecodedMap(); // { version: 3, names: [], sources: [], mappings: [] }

Known differences with other implementations

This implementation has some differences with source-map and source-map-js.

• SourceMapConsumer.prototype.eachMapping()
  • Does not support the order argument
• SourceMapGenerator.prototype.applySourceMap()
  • Not implemented