apply-sourcemaps

Fetch and apply sourcemaps in logs and stack traces originating from the browser or puppeteer.

npm i apply-sourcemaps

pnpm add apply-sourcemaps

yarn add apply-sourcemaps

API

# getRealLocationFromUrlLineCol

src/get-real-location-from-line-col.ts#L36

# clear()
src/get-real-location-from-line-col.ts#L46
clear()  =>

void

# RealLocation

src/get-real-location-from-line-col.ts#L4

# column

src/get-real-location-from-line-col.ts#L8

string | number

# line

src/get-real-location-from-line-col.ts#L7

string | number

# originalUrl

src/get-real-location-from-line-col.ts#L5

string

# url

src/get-real-location-from-line-col.ts#L6

string

# Sources

src/fetch-source-map.ts#L10

# source

src/fetch-source-map.ts#L11

string

# sourceMap
src/fetch-source-map.ts#L12
{

# sourcemap

src/fetch-source-map.ts#L13

undefined | RawSourceMap

}

# applySourceMaps(x, mapFn)

src/apply-sourcemaps.ts#L14

# x

string

# mapFn(url)
# url

string

mapFn(url)  =>

string

applySourceMaps(x, mapFn)  =>

Promise<string>

# clearAllCaches()

src/util.ts#L5

clearAllCaches()  =>

void

# createDeferredCache(fn)

src/util.ts#L11

# fn(id, rest)
# id

string

# rest

U

fn(id, rest)  =>

Promise<T>

createDeferredCache<T, U>(fn)  =>

# (key, args)
# key

string

# args

U

(key, args)  =>

Promise<T>

# fetch(input, init)

src/fetch-source-map.ts#L17

# input

string | Request

# init

Partial<FetchInit>

fetch(input, init)  =>

Promise<Response>

# fetchSourceMap(key, args)

src/fetch-source-map.ts#L23

# key

string

# args

[ ]

fetchSourceMap(key, args)  =>

Promise<undefined | Sources>

# getCodeFrame(message, { column, line, originalUrl, url })

src/get-code-frame.ts#L4

# message

string

{
# column

src/get-code-frame.ts#L6

string | number

# line

src/get-code-frame.ts#L6

string | number

# originalUrl

src/get-code-frame.ts#L6

string

# url

src/get-code-frame.ts#L6

string

}

getCodeFrame(message, { column, line, originalUrl, url })  =>

Promise<undefined | string>

# getIt(key, args)

src/get-real-location-from-line-col.ts#L13

# key

string

# args

[ RealLocation ]

getIt(key, args)  =>

Promise<void | RealLocation>

# getRealLocationFromUrlLineCol(real)

src/get-real-location-from-line-col.ts#L36

# real

RealLocation

getRealLocationFromUrlLineCol(real)  =>

Promise<void | RealLocation>

# getSourceMap(url, content)

src/get-source-map.ts#L9

# url

string

# content

string

getSourceMap(url, content)  =>

Promise<undefined | RawSourceMap>

# log(formatter, args)

src/apply-sourcemaps.ts#L5

# formatter

any

# args

any []

log(formatter, args)  =>

void

# parseUrls(x)

src/parse-urls.ts#L5

# x

string

parseUrls(x)  =>

{
# column

src/parse-urls.ts#L14

string

# line

src/parse-urls.ts#L13

string

# originalUrl

src/parse-urls.ts#L11

string

# url  =  ...

src/parse-urls.ts#L12

string

} []

Credits

• @babel/code-frame by The Babel Team – Generate errors that contain a code frame that point to source locations.
• convert-source-map by Thorsten Lorenz – Converts a source-map from/to different formats and allows adding/changing properties.
• debug by Josh Junon – Lightweight debugging utility for Node.js and the browser
• everyday-utils by stagas – Everyday utilities
• fetch-h2 by Gustaf Räntilä – HTTP/1+2 Fetch API client for Node.js
• source-map by Nick Fitzgerald – Generates and consumes source maps

Contributing

Fork or edit and submit a PR.

All contributions are welcome!

License

MIT © 2022 stagas