[][src]Crate sourcemap

This library implements basic processing of JavaScript sourcemaps.

Installation

The crate is called sourcemap and you can depend on it via cargo:

[dependencies]
sourcemap = "*"

If you want to use the git version:

[dependencies.sourcemap]
git = "https://github.com/getsentry/rust-sourcemap.git"

Basic Operation

This crate can load JavaScript sourcemaps from JSON files. It uses serde for parsing of the JSON data. Due to the nature of sourcemaps the entirety of the file must be loaded into memory which can be quite memory intensive.

Usage:

use sourcemap::SourceMap;
let input: &[_] = b"{
    \"version\":3,
    \"sources\":[\"coolstuff.js\"],
    \"names\":[\"x\",\"alert\"],
    \"mappings\":\"AAAA,GAAIA,GAAI,EACR,IAAIA,GAAK,EAAG,CACVC,MAAM\"
}";
let sm = SourceMap::from_reader(input).unwrap();
let token = sm.lookup_token(0, 0).unwrap(); // line-number and column
println!("token: {}", token);

Features

Functionality of the crate can be turned on and off by feature flags. This is the current list of feature flags:

Modules

vlq

Implements utilities for dealing with the sourcemap vlq encoding.

Structs

IndexIter

Iterates over all index items in a sourcemap

NameIter

Iterates over all tokens in a sourcemap

RawToken

Represents a raw token

RewriteOptions

Controls the SourceMap::rewrite behavior

SourceContentsIter

Iterates over all source contents in a sourcemap

SourceIter

Iterates over all sources in a sourcemap

SourceMap

Represents a sourcemap in memory

SourceMapBuilder

Helper for sourcemap generation

SourceMapHermes

Represents a react-native-style SourceMap, which has additional scope information embedded.

SourceMapIndex

Represents a sourcemap index in memory

SourceMapSection

Represents a section in a sourcemap index

SourceMapSectionIter

Iterates over all sections in a sourcemap index

SourceView

Provides efficient access to minified sources.

Token

Represents a token from a sourcemap

TokenIter

Iterates over all tokens in a sourcemap

Enums

DecodedMap

Represents the result of a decode operation

Error

Represents different failure cases

SourceMapRef

Represents a reference to a sourcemap

Functions

decode

Decodes a sourcemap or sourcemap index from a reader

decode_data_url

Loads a sourcemap from a data URL

decode_slice

Decodes a sourcemap or sourcemap index from a byte slice

is_sourcemap

Checks if a valid sourcemap can be read from the given reader

is_sourcemap_slice

Checks if the given byte slice contains a sourcemap

locate_sourcemap_reference

Locates a sourcemap reference

locate_sourcemap_reference_slice

Locates a sourcemap reference in a slice

make_relative_path

Helper function to calculate the path from a base file to a target file.

Type Definitions

Result

Represents results from this library