Source Maps

How can I upload JavaScript Source Maps via Zipy CLI?

Zipy CLI helps in debugging the minified stack trace that occurs on the user's browser environment. The minified stack trace can be parsed, so that you can see the actual source code with the help of source maps. This lets you view the actual source context of the frontend JavaScript errors, including the code from any other libraries that you may have used in your frontend code. How to enable this feature? You will have to upload the source maps to Zipy Server with the help of the CLI. The package can be globally installed and integrated in the build steps for smoother integration. Following are the steps to upload the source map files:

// Globally Install the CLI Package -

npm i -g zipy-cli

// CLI Command -

zipy-cli --authKey authKey --dirname ~/sourcemaps/ --apiKey YOUR_PROJECT_SDK_KEY --releaseVer releaseVerString

// CLI help Command -

zipy-cli --help

Below are the params accepted by the CLI:

• authKey: It is an authentication key for your Zipy projects.

• dirname: A string value of the directory where source maps are available

• apiKey: Zipy Project Key

• releaseVer: Release Version of your application

Please contact Zipy via chat or send us an email at [email protected] to get an authorization key for access. Note that you can upload only up to 100 and a maximum of 100 MB files at once.

Controlling log output

The CLI supports a -v or --verbose flag that enables detailed file upload output. Without this flag, only minimal logs are shown in the terminal. With this flag, the CLI prints detailed filenames and progress information during sourcemap uploads.

Example

zipy-cli --authKey authKey --dirname ~/sourcemaps/ --apiKey YOUR_PROJECT_SDK_KEY --releaseVer releaseVerString --verbose

Why can't I see the proper stack trace?

If you are unable to see the proper stack trace in your Zipy dev tools section, please verify the following:

1. Check if you initialized the SDK with a proper release version. Make sure the release version for which the sourcemaps have been uploaded matches with SDK init release version.

2. Confirm if you uploaded all the source map files. Stack traces can be broken if some source map files are missing.