Errors are used to notify a user when a critical issue has occurred or to log recoverable issues. An error object consists of three mandatory parameters:

  • Error Severity
  • Error Category
  • Error Code
  • Error Custom Data - An optional object with additional information about the issue.

There are two severities to an error:

  • A critical error is triggered in an error event and is shown to the user as error overlay in the player itself.
  • A recoverable error is not shown to an end user, but appears in the console.

Error Lists

You’ll find the full lists of errors here:

Listening to an Error Event

You can listen to errors the player emits by listening to an ‘error’ event as follows:

player.addEventListener(player.Event.ERROR, event => {
  const error = e.payload;
  console.log('The error severity is: ' + error.severity);
  console.log('The error category is: ' + error.category);
  console.log('The error code is: ' + error.code);
  console.log('The error data is', error.data);
});

Creating an Error

If you wish to change / emit an error event, you’ll need to create an error object in the following manner:

const myError = new Error(Error.Severity.CRITICAL, Error.Category.NETWORK, Error.Code.HTTP_ERROR, {url: 'www.some-bad-url.com'});

Next, you’ll need to dispatch an Error event:

player.dispatchEvent(new FakeEvent(player.Event.Error, myError));

You can find additional information about dispatching events here.

Using Debug Mode to See Explicit Error Messages

Use the debug mode in the player to view explicit error messages in the console, which look something like this:

[Error] Category:1 | Code:1002 | 'Http Error'

You can find additional information about debugging and troubleshooting the player here.