resolve-browser-trace

When it comes to the stability of your web application, knowing when your production users have a problem is critical!

When we develop locally. We can have the convenience of a readable stacktrace to let you know what has happened. However, with your live site, letting the whole world know how our source is constructed is not something we may want.

The Problem:

How can we get a useful stack trace from client-side errors without exposing the inner workings?

The Solution:

Send the client Error & stack to the Server. Then get the server to clean up the stack-trace before it gets saved your logs for review.

resolve-browser-trace is a NodeJs library to rebuild client side stacktraces into source pointers

If this was helpful, ★ it on github

Install

yarn add resolve-browser-trace or npm install --save resolve-browser-trace

constructor / setup

The first step to import the lib

1const setupResolveTrace = require('resolve-browser-trace')

Next is to set the path to where you store your map files for your bundles

1const sourceDecoder = setupResolveTrace(__dirname+"/src/ .map files are here");

To use just pass the stacktrace

1sourceDecoder(stack) // returns Promise

Example

1const sourceDecoder = require('resolve-browser-trace')(__dirname+"/src/ .map files are here")
2
3const clientStacktrack = `@https://localhost/main-9adc196540168f060d54.min.js:1:3385
4@https://localhost/main-9adc196540168f060d54.min.js:1:96`;
5
6sourceDecoder(clientStacktrack).then(newStack => console.log(newStack))
7/* RESULT -> [
8  {
9    "source": "main.jsx",
10    "line": 20,
11    "column": 21,
12    "arguments": [],
13    "name": appElem
14  },
15  {
16    "source": "webpack/bootstrap 9adc196540168f060d54",
17    "line": 19,
18    "column": 0,
19    "arguments": [],
20    "name": "modules",
21  }
22]*/

setup your webpack

webpack.config.js

1module.exports = {
2  // ...
3  target:"web",
4  devtool: 'source-map',
5  output: {
6    path: path.resolve(__dirname, "public"),
7    filename: "[name]-[hash].min.js"
8  },
9  // ...