Configuration

Configuration file (server-side only)

When using the JavaScript client in a Node.js environment, you can configure Honeybadger using a configuration file in your project's root directory, such as honeybadger.config.js or honeybadger.config.ts. The configuration file should export an object with the configuration.

An example configuration file is shown below:

javascript
// honeybadger.config.js module.exports = { apiKey: process.env.HONEYBADGER_API_KEY, environment: process.env.NODE_ENV, revision: process.env.HONEYBADGER_REVISION // etc. }

Configuration Options

All of the available configuration options are shown below:

javascript
Honeybadger.configure({ // Honeybadger API key (required) apiKey: '', // The revision of the current deploy revision: '', // Project root projectRoot: 'http://my-app.com', // Environment environment: 'production', // Defaults to the server's hostname in Node.js hostname: 'badger01', // Environments which will not report data developmentEnvironments: ['dev', 'development', 'test'], // Override `developmentEnvironments` to explicitly enable/disable error reporting // reportData: true, // Key values to filter from request data. Matches are partial, so "password" // and "password_confirmation" will both be filtered filters: ['creditcard', 'password'], // Component (optional) component: '', // Action (optional) action: '', // Should unhandled errors be reported? // This option uses `window.onerror` in browsers and `uncaughtException` in Node.js enableUncaught: true, // Executed after `uncaughtException` in Node.js // afterUncaught: ->(error) {}, // Should unhandled Promise rejections be reported? enableUnhandledRejection: true, // Enable breadcrumbs collection breadcrumbsEnabled: true, // Automatically send console logs to Honeybadger Insights eventsEnabled: true, // Collector Host endpoint: 'https://api.honeybadger.io', // The maximum number of breadcrumbs to include with error reports maxBreadcrumbs: 40, // The maximum depth allowed in deeply-nested objects maxObjectDepth: 8, // The logger to use. Should behave like `console` logger: console, // Output Honeybadger debug messages to the logger debug: false });

The following additional options are available in browser environments:

javascript
Honeybadger.configure({ // Send notifications asynchronously async: true, // Endpoint to submit user feedback for errors. See "Collecting User Feedback". userFeedbackEndpoint: 'https://api.honeybadger.io/v2/feedback', // Limit the maximum number of errors the client will send to Honeybadger // after page load. Default is unlimited (undefined) maxErrors: 20, // Enable breadcrumbs collection breadcrumbsEnabled: true // You can also selectively configure these types of breadcrumbs: // breadcrumbsEnabled: { // dom: true, // network: true, // navigation: true, // console: true // } });

Configuring with Environment Variables

Unlike some of our other client libraries, honeybadger.js does not automatically read configuration from environment variables; to use environment variables, you must configure Honeybadger like this:

javascript
Honeybadger.configure({ apiKey: process.env.HONEYBADGER_API_KEY, environment: process.env.NODE_ENV, revision: process.env.HONEYBADGER_REVISION, // etc. });

Note that process.env may not be available outside of Node.js by default (it depends on your JavaScript build system). For example, in Webpack you need to use environmentPlugin to make process.env keys available in source files.

beforeNotify Handlers

beforeNotify handlers run before each notice (error report) is sent to Honeybadger. There are two cases this might be useful:

  1. Filtering out unwanted error reports by returning false from a handler
  2. Sanitizing or enhancing notice data before being sent to Honeybadger

Usage Examples

Sanitizing notice data:

javascript
Honeybadger.beforeNotify((notice) => { if (/creditCard/.test(notice.url)) { notice.url = '[FILTERED]'; } });

Adding additional context to notice data:

javascript
Honeybadger.beforeNotify((notice) => { notice.context.session_id = MyApp.sessionId; });

Adding additional context to notice data from an async source:

javascript
Honeybadger.beforeNotify(async (notice) => { notice.context.state = await MyApp.getState(); });

Skipping a notice:

javascript
Honeybadger.beforeNotify((notice) => { if (/third-party-domain/.test(notice.stack)) { return false; } });

afterNotify Handlers

afterNotify handlers run after each notice (error report) is sent to Honeybadger. Here are two cases where this is useful:

  1. Displaying the ID of the Honeybadger notice to users
  2. Handling errors if the Honeybadger API rejects the notice

Usage Examples

Log a URL to the error report in Honeybadger:

javascript
Honeybadger.afterNotify((err, notice) => { if (err) { return console.log(`Honeybadger notification failed: ${err}`); } console.log(`Honeybadger notice: https://app.honeybadger.io/notice/${notice.id}`); });

An afterNotify handler can also be attached to a single error report:

javascript
Honeybadger.notify('testing', { afterNotify: (err, notice) => console.log(err || notice.id) })

Notice Properties

The following notice properties are available in notice objects:

  • notice.stack - The stack trace (read only)
  • notice.backtrace - The parsed backtrace object
  • notice.name - The exception class name
  • notice.message - The error message
  • notice.url - The current url
  • notice.projectRoot - The root url
  • notice.environment - Name of the environment. example: "production"
  • notice.component - Similar to a rails controller name. example: "users"
  • notice.action - Similar to a rails action name. example: "create"
  • notice.fingerprint - A unique fingerprint, used to customize grouping of errors in Honeybadger
  • notice.context - The context object
  • notice.tags - A string comma-separated list of tags
  • notice.params - An object of request parameters
  • notice.session - An object of request session key/values
  • notice.headers - An object of request headers
  • notice.cookies - An object of cookie key/values. May also be sent as a string in the document.cookie "foo=bar;bar=baz" format.

The following additional notice properties are available in afterNotify handlers:

  • notice.id - The UUID of the error in Honeybadger