Installing Airbrake in a Browserify application

Features

  • Easy and flexible installation options including NPM, Bower and a public CDN
  • Send uncaught errors to Airbrake or manually using a try/catch
  • Add custom parameters to your errors for more context
  • Private sourcemap support
  • Control which errors you send with customizable filtering options

Installation

Using npm

npm install airbrake-js

Using Bower

bower install airbrake-js-client

Configuration

To report errors from your Browserify app you configure an AirbrakeClient with your projectId and projectKey and report errors with the notify function. Here is an example from our Browserify example app:

function start() {
  var AirbrakeClient = require('airbrake-js');

  var airbrake = new AirbrakeClient({
    projectId: 1,
    projectKey: 'FIXME'
  });

  try {
    throw new Error('hello from Browserify');
  } catch (err) {
    promise = airbrake.notify(err);
    promise.then(function(notice) {
      console.log('notice id:', notice.id);
    }, function(err) {
      console.log('airbrake failed:', err);
    });
  }
}

start();

Going Further

Installation and configuration is just the beginning. The airbrake-js notifier supports many other advanced uses and options including:

Please visit the airbrake-js GitHub repo for more usage and configuration examples.