Rollbar.js

Proactively discover, predict, and resolve errors in real-time with Rollbar’s error monitoring platform. Start tracking errors today!

!Build Status

• Cross platform: Rollbar.js supports both server-side and client-side Javascript, including frameworks such as React, Angular, Express, Next.js and more.
• Telemetry: The telemetry timeline provides a list of “breadcrumbs” events that can help developers understand and fix problems in their client-side javascript. Learn more about telemetry.
• Automatic error grouping: Rollbar aggregates Occurrences caused by the same error into Items that represent application issues. Learn more about reducing log noise.
• Advanced search: Filter items by many different properties. Learn more about search.
• Customizable notifications: Rollbar supports several messaging and incident management tools where your team can get notified about errors and important events by real-time alerts. Learn more about Rollbar notifications.

Session Replay (Beta)

Important: Session Replay is now available in beta! This feature captures and replays user sessions around errors, helping you understand exactly what happened before an error occurred. Replay can also be triggered based on custom conditions to capture critical user flows.

Because Session Replay includes additional recording capabilities, it uses a separate, larger bundle. If you want to use Session Replay, import from rollbar/replay instead of rollbar:

// Standard bundle (smaller, no replay)
import Rollbar from 'rollbar';
// Session Replay bundle (includes replay capabilities)
import Rollbar from 'rollbar/replay';

Choose the standard bundle if you don't need replay functionality.

For Session Replay configuration and usage, see our Session Replay documentation.

Installation

Using npm:

npm install --save rollbar

Using yarn:

yarn add rollbar

For CDN/script tag installation, see Quick Start → Browser

Quick Start

First, sign up for a Rollbar account if you haven't already.

Browser

For the recommended snippet-based installation with automatic error capture and telemetry, see our Browser JS – Quick Start documentation.

Node.js

const Rollbar = require('rollbar');
const rollbar = new Rollbar({
  accessToken: 'POST_SERVER_ITEM_ACCESS_TOKEN',
  captureUncaught: true,
  captureUnhandledRejections: true,
  payload: { code_version: '1.0.0' },
});
// log a generic message and send to rollbar
rollbar.log('Hello world!');

For framework integrations (Express, Koa, Hapi, and more), custom error handlers, and advanced configuration, see our Node.js server configuration documentation.

Usage and Reference

For complete usage instructions and configuration reference, see our Javascript SDK docs.

Examples

See the examples directory for detailed integration examples with various frameworks and build tools including React, Angular, Vue.js, Next.js, and more.

Release History & Changelog

See our Releases page for a list of all releases, including changes.

Help / Support

If you run into any issues, please email us at [email protected].

For bug reports, please open an issue on GitHub.

Developing and Contributing

For development setup, guidelines, and instructions on submitting pull requests, please see our Contributing Guide.