A Webpack plugin to upload sourcemaps to Rollbar after build
Last updated 2 years ago by igorcr .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @lets_events/rollbar-sourcemap-webpack-plugin 
SYNC missed versions from official npm registry.


Dependency Status devDependency Status Build Status Coverage Downloads

This is a Webpack plugin that simplifies uploading the sourcemaps, generated from a webpack build, to Rollbar.

Production JavaScript bundles are typically minified before deploying, making Rollbar stacktraces pretty useless unless you take steps to upload the sourcemaps. You may be doing this now in a shell script, triggered during your deploy process, that makes curl posts to the Rollbar API. This can be finicky and error prone to setup. RollbarSourceMapPlugin aims to remove that burden and automatically upload the sourcemaps when they are emitted by webpack.


Install the plugin with npm:

$ npm install rollbar-sourcemap-webpack-plugin --save-dev

Basic Usage

An example webpack.config.js:

const RollbarSourceMapPlugin = require('rollbar-sourcemap-webpack-plugin')
const PUBLIC_PATH = 'https://my.cdn.net/assets'
const webpackConfig = {
  entry: 'index',
  publicPath: PUBLIC_PATH,
  output: {
    path: 'dist',
    filename: 'index-[hash].js'
  plugins: [new RollbarSourceMapPlugin({
    accessToken: 'aaaabbbbccccddddeeeeffff00001111',
    version: 'version_string_here',
    publicPath: PUBLIC_PATH

Plugin Configuration

You can pass a hash of configuration options to RollbarSourceMapPlugin. Allowed values are as follows:

accessToken: string (required)

Your rollbar post_server_item access token.

version: string (required)

A string identifying the version of your code this source map package is for. Typically this will be the full git sha.

publicPath: string | function(string): string (required)

The base url for the cdn where your production bundles are hosted or a function that receives the source file local address and returns the url for that file in the cdn where your production bundles are hosted.

includeChunks: string | [string] (optional)

An array of chunks for which sourcemaps should be uploaded. This should correspond to the names in the webpack config entry field. If there's only one chunk, it can be a string rather than an array. If not supplied, all sourcemaps emitted by webpack will be uploaded, including those for unnamed chunks.

silent: boolean (default: false)

If false, success and warning messages will be logged to the console for each upload. Note: if you also do not want to see errors, set the ignoreErrors option to true.

ignoreErrors: boolean (default: false)

Set to true to bypass adding upload errors to the webpack compilation. Do this if you do not want to fail the build when sourcemap uploads fail. If you do not want to fail the build but you do want to see the failures as warnings, make sure silent option is set to false.

rollbarEndpoint: string (default: https://api.rollbar.com/api/1/sourcemap)

A string defining the Rollbar API endpoint to upload the sourcemaps to. It can be used for self-hosted Rollbar instances.

App Configuration

  • The web app should have rollbar-browser installed and configured for webpack as described here.
  • See the Rollbar source map documentation for how to configure the client side for sourcemap support. The code_version parameter must match the version parameter used for the plugin.
  • More general info on the using Rollbar for browser JS.


React (source)

A minimal single page app with webpack build. The app includes a local Express server that serves an index.html. The build is meant to mimic a production build in that js bundles and sourcemaps are uploaded to AWS S3. You will need AWS and Rollbar accounts. To run the example:

  • Set your aws and rollbar options in examples/react/webpack.config.babel.js
  • $ cd examples/react
  • $ npm run build
  • $ npm start
  • open http://localhost:8000

When the example app is loaded in a browser, the app will throw an error, which will be sent to Rollbar. You should be able to log in to Rollbar and see the error with stacktrace with line numbers that map to the original source.


See the Contributors Guide



Current Tags

  • 2.5.0                                ...           latest (2 years ago)

1 Versions

  • 2.5.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 3
Last Month 3
Dependencies (9)
Dev Dependencies (16)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |