Customize the React SDK error handler

2 min

In a production environment, you should have full control and visibility over the errors that are happening in your application, including those that would originate from an Optimizely SDK.

The SDKs provide default implementations of an error handler, which is a no-op handler. The following is an example of using the default error handler from the SDKs:

import {
  errorHandler,
  createInstance,
} from '@optimizely/react-sdk'

const optimizely = createInstance({
  // No datafile will trigger the custom error handler,
  // but the default error handler is a no-op
  datafile: null,
  errorHandler: errorHandler
});

However, for additional control and visibility into the errors coming from the SDK, you should implementing your own custom error handler.

With a custom error handler, you can choose what to do with an error, whether it may be as simple as logging the error to console or sending the error to another error monitoring service.

The following is an example of using a custom error handler to log errors to the console:

import {
  createInstance,
} from '@optimizely/react-sdk'

/**
 * customErrorHandler
 *
 * Object that has a property `handleError` which will be called
 * when an error is thrown in the SDK.
 */
const customErrorHandler = {
  /**
   * handleError
   *
   * Function which gets called when an error is thrown in the SDK
   * @param {Object} error - error object
   * @param {String} error.message - message of the error
   * @param {String} error.stack - stack trace for the error
   */
  handleError: function(error) {
    console.log('CUSTOM_ERROR_HANDLER');
    console.log('****');
    console.log(`Error Message: ${error.message}`);
    console.log(`Error Stack: ${error.stack}`);
    console.log('****');
  }
}
 
const optimizelyClientInstance = OptimizelySdk.createInstance({
  // No datafile will trigger the custom error handler,
  datafile: null,
  errorHandler: customErrorHandler,
});

Important Turning off logging with setLogger(null) will suppress the error handler from handling an error.