Rollup plugin to upload JavaScript source maps and optionally send deployment notifications to Honeybadger.
Supports rollup version 3. If you use rollup version 2, you can either upgrade or send your source maps to Honeybadger's API directly.
# npm
npm install @honeybadger-io/rollup-plugin --save-dev
# yarn
yarn add @honeybadger-io/rollup-plugin --dev
These plugin parameters correspond to the Honeybadger Source Map Upload API and Deployments API.
-
apiKey
(required) - The API key of your Honeybadger project
-
assetsUrl
(required) - The base URL to production assets (scheme://host/path)
*
wildcards are supported. The plugin combinesassetsUrl
with the generated minified js file name to build the API parameterminified_url
-
endpoint
(optional — default: "https://api.honeybadger.io/v1/source_maps") - Where to upload your source maps to. Perhaps you have a self hosted source map server you would like to upload your source maps to instead of Honeybadger.
-
revision
(optional — default: "main") - The deploy revision (i.e. commit hash) that your source map applies to. This could also be a code version. For best results, set it to something unique every time your code changes. See the Honeybadger docs for examples.
-
silent
(optional — default: false) - If true, silence logging emitted by the plugin.
-
retries
(optional — default: 3, max: 10) - This package implements fetch retry functionality via the fetch-retry package. Retrying helps fix issues like `ECONNRESET` and `SOCKETTIMEOUT` errors.
-
workerCount
(optional — default: 5, min: 1) - Source maps are uploaded in parallel by a configurable number of workers. Increase or decrease this value to configure how many source maps are being uploaded in parallel. Limited parallelism helps with connection issues in Docker environments.
-
ignorePaths
(optional — default: []) - An array of paths (glob patterns) to ignore when uploading source maps. Uses picomatch to match against paths.
-
deployEndpoint
(optional — default: "https://api.honeybadger.io/v1/deploys") - Where to send deployment notifications.
-
deploy
(optional — default: false) -
Configuration for deployment notifications. To disable deployment notifications, ignore this option. To enable deployment notifications, set this to
true
, or to an object containing any of the fields below. Your deploy'srevision
will be set to the same value as for your source maps (see above).environment
- The environment name, for example, "production"
repository
- The base URL of the VCS repository (HTTPS-style), for example, "https://github.com/yourusername/yourrepo"
localUsername
- The name of the user that triggered this deploy, for example, "Jane"
Set output.sourcemap
to true
or 'hidden'
. Add the honeybadger plugin to the plugins array.
import honeybadgerRollupPlugin from '@honeybadger-io/rollup-plugin'
// See plugin params above
const hbPluginOptions = {
apiKey: 'your_key_here',
assetsUrl: 'https://yoursite.foo'
}
export default {
input: 'src/index.js',
output: {
dir: 'dist',
sourcemap: true // Must be true or 'hidden'
},
plugins: [ honeybadgerRollupPlugin(hbPluginOptions) ],
}
If you're using Vite, you'll set up vite.config.js
instead of rollup.config.js
.
Set build.sourcemap
to true
or 'hidden'
. Add the honeybadger
plugin to rollupOptions.plugins
.
Note: Be careful not to add it to the top-level vite plugins without additional config, or it will upload source maps on serve
rather than just on build
.
import honeybadgerRollupPlugin from '@honeybadger-io/rollup-plugin'
import { defineConfig } from 'vite'
// See plugin params above
const hbPluginOptions = {
apiKey: 'your_key_here',
assetsUrl: 'https://yoursite.foo'
}
export default defineConfig({
plugins: [], // Not here
build: {
sourcemap: true, // Must be true or 'hidden'
rollupOptions: {
plugins: [ honeybadgerRollupPlugin(hbPluginOptions) ]
}
}
})
- Run
npm install
- Run the tests with
npm test
- Build with
npm run build
See the /examples
folder for projects to test against.
This package is MIT licensed. See the MIT-LICENSE file in this folder for details.