CONNECT Player SDK 1 for Browsers

Error handling during initialisation

There may be a failure during player initialization which results in the player object not being returned. Since there is no object instance to attach listeners onto, no errors can be caught.

To deal with this the otvtoolkit allows for a creationFailureCallback property on its plugin options. In the event of an error during initialisation, this will be called with an error object passed in as the only parameter.

The error object will have a `name` and a `message` property that can be used to determine the nature of the error.

JavaScript
let playerInstance = otvplayer(
    "videoPlayer",
    // options
    {
        plugins: {
            otvtoolkit: {
                creationFailureCallback: onCreationFailureCallback
            }
        }
    },
    // loaded callback
    function loadedCallback() {
    ...
    }
);
 
function onCreationFailureCallback(creationError) {
  console.error(creationError.name + ": " + creationError.message);
}

An invalid video ID being passed to the player, otvplayer will generate a TypeException, for an invalid plugin or plugin component, otvplayer will generate a ReferenceException.