How to Handle Media Errors

There is a very simple way to handle media errors in HTML5. HTML5 provides an event that fires whenever an error occurs, allowing your application to listen for it. Your application can gracefully detect and handle the event when a media player cannot play or cannot continue to play an asset:

  • Error in decoding (bad codec, MOV ATOM was at end of file, etc)
  • Network Error (404, etc)
  • Source format not supported

The error itself is available in the event by using which is of type MediaError. Currently there are four types of errors which are enumerated in ALL CAPS within the MediaError prototype:


The following example is a typical way to deal with an error:

var videoErrorHandler = function (evt) {
        var error = '';
        switch ( {
        case MediaError.MEDIA_ERR_ABORTED:
            error = "Video was aborted";
        case MediaError.MEDIA_ERR_NETWORK:
            error = "There was a network error with the video";
        case MediaError.MEDIA_ERR_DECODE:
            error = "Could not decode the video, is the source " + + " using a supported decoder";
        case MediaError.MEDIA_ERR_NOT_SUPPORTED:
            error = "Video was aborted";
        document.getElementById('errorDiv').innerHTML = error;
document.querySelector('video').addEventListener('error', videoErrorHandler);

The above example listens for an error, and then does a switch of the error code (1 through 4, but we do not use the numbers themselves because the constants MediaError.[[CONSTANT_NAME]] are more the standard practice and better suited for an evolving specification). We then display the appropriate friendly error message in a div with the ID errorDiv.

This is a simplistic approach. We recommend you generally provide a standard error page in your application (error.html) and pass any errors to the page (location.href = "error.html?error=Some_error_message"). That way, error messages are consistent throughout your application. However, that topic will be discussed elsewhere. Provide your users with feedback when there is an error, even when the probability of an error is near zero. 

  • Tuesday, 22 November 2011
  • Posted in: Advanced
  • Number of Views: 4141

Your destination to find out more about just how easy it is to develop advanced applications that leverage the “write-once, deploy-everywhere” content creation environment of ActiveVideo’s CloudTV™ platform. You will be able to significantly reduce app time-to-market for connected devices of all types, as well as cable settop boxes that have no additional connectivity. Manufacturers and virtual service providers, as well as cable and IPTV operators around the world are currently benefiting from the advantages of ActiveVideo’s CloudTV platform.

© 2019 Active Video Networks. All Rights Reserved