Source: lib/util/error.js

  1. /*! @license
  2.  * Shaka Player
  3.  * Copyright 2016 Google LLC
  4.  * SPDX-License-Identifier: Apache-2.0
  5.  */
  7. goog.provide('shaka.util.Error');
  10. /**
  11.  * @summary
  12.  * Describes an error that happened.
  13.  *
  14.  * @description
  15.  * This uses numerical codes to describe
  16.  * which error happened.
  17.  *
  18.  * Some error are caused by errors from the browser.  In these cases, the error
  19.  * object is provided as part of the <code>data</code> field.  System codes come
  20.  * from the browser and may or may not be documented.  Here are some places
  21.  * where the errors may be documented:
  22.  * <ul>
  23.  *   <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaError">MediaError</a>
  24.  *   <li><a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status">HTTP Codes</a>
  25.  *   <li><a href="https://hresult.info">Edge/PlayReady errors</a>
  26.  * </ul>
  27.  *
  28.  * @export
  29.  * @implements {shaka.extern.Error}
  30.  * @extends {Error}
  31.  */
  32. shaka.util.Error = class {
  33.   /**
  34.    * @param {shaka.util.Error.Severity} severity
  35.    * @param {shaka.util.Error.Category} category
  36.    * @param {shaka.util.Error.Code} code
  37.    * @param {...*} varArgs
  38.    */
  39.   constructor(severity, category, code, ...varArgs) {
  40.     /**
  41.      * @override
  42.      * @exportInterface
  43.      */
  44.     this.severity = severity;
  45.     /**
  46.      * @override
  47.      * @exportInterface
  48.      */
  49.     this.category = category;
  50.     /**
  51.      * @override
  52.      * @exportInterface
  53.      */
  54.     this.code = code;
  55.     /**
  56.      * @override
  57.      * @exportInterface
  58.      */
  59.     this.data = varArgs;
  60.     /**
  61.      * @override
  62.      * @exportInterface
  63.      */
  64.     this.handled = false;
  66.     // A basic message for compiled mode.
  67.     let formattedMessage = 'Shaka Error ' + this.code;
  68.     if (goog.DEBUG) {
  69.       // This improves the formatting of Errors in failure messages in the
  70.       // tests in debug mode.
  71.       let categoryName = 'UNKNOWN';
  72.       let codeName = 'UNKNOWN';
  74.       for (const k in shaka.util.Error.Category) {
  75.         if (shaka.util.Error.Category[k] == this.category) {
  76.           categoryName = k;
  77.         }
  78.       }
  79.       for (const k in shaka.util.Error.Code) {
  80.         if (shaka.util.Error.Code[k] == this.code) {
  81.           codeName = k;
  82.         }
  83.       }
  85.       formattedMessage = 'Shaka Error ' + categoryName + '.' + codeName +
  86.                          ' (' + this.data.toString() + ')';
  87.     }
  89.     /**
  90.      * In compiled mode, contains a basic message string with the error code.
  91.      * In uncompiled and debug modes, contains a human-readable version of the
  92.      * category and code as enums.
  93.      *
  94.      * @const {string}
  95.      * @exportDoc
  96.      */
  97.     this.message = formattedMessage;
  99.     if (shaka.util.Error.createStack) {
  100.       try {
  101.         throw new Error(this.message || 'Shaka Error');
  102.       } catch (e) {
  103.         /**
  104.          * A stack-trace showing where the error occurred.
  105.          *
  106.          * @const {string}
  107.          * @exportDoc
  108.          */
  109.         this.stack = e.stack;
  110.       }
  111.     }
  112.   }
  115.   /**
  116.    * @return {string}
  117.    * @override
  118.    */
  119.   toString() {
  120.     return 'shaka.util.Error ' + JSON.stringify(this, null, '  ');
  121.   }
  122. };
  125. /**
  126.  * If true, create a stack trace in Error objects.
  127.  *
  128.  * Disabled in tests to avoid issues with karma-jasmine.
  129.  * See comments in test/test/boot.js for details.
  130.  *
  131.  * @type {boolean}
  132.  */
  133. shaka.util.Error.createStack = true;
  135. /**
  136.  * @enum {number}
  137.  * @export
  138.  */
  139. shaka.util.Error.Severity = {
  140.   /**
  141.    * An error occurred, but the Player is attempting to recover from the error.
  142.    *
  143.    * If the Player cannot ultimately recover, it still may not throw a CRITICAL
  144.    * error.  For example, retrying for a media segment will never result in
  145.    * a CRITICAL error (the Player will just retry forever).
  146.    */
  147.   'RECOVERABLE': 1,
  149.   /**
  150.    * A critical error that the library cannot recover from.  These usually cause
  151.    * the Player to stop loading or updating.  A new manifest must be loaded
  152.    * to reset the library.
  153.    */
  154.   'CRITICAL': 2,
  155. };
  158. /**
  159.  * @enum {number}
  160.  * @export
  161.  */
  162. shaka.util.Error.Category = {
  163.   /** Errors from the network stack. */
  164.   'NETWORK': 1,
  166.   /** Errors parsing text streams. */
  167.   'TEXT': 2,
  169.   /** Errors parsing or processing audio or video streams. */
  170.   'MEDIA': 3,
  172.   /** Errors parsing the Manifest. */
  173.   'MANIFEST': 4,
  175.   /** Errors related to streaming. */
  176.   'STREAMING': 5,
  178.   /** Errors related to DRM. */
  179.   'DRM': 6,
  181.   /** Miscellaneous errors from the player. */
  182.   'PLAYER': 7,
  184.   /** Errors related to cast. */
  185.   'CAST': 8,
  187.   /** Errors in the database storage (offline). */
  188.   'STORAGE': 9,
  190.   /** Errors related to ad insertion. */
  191.   'ADS': 10,
  192. };
  195. /**
  196.  * @enum {number}
  197.  * @export
  198.  */
  199. shaka.util.Error.Code = {
  200.   /**
  201.    * A network request was made using an unsupported URI scheme.
  202.    * <br> error.data[0] is the URI.
  203.    */
  204.   'UNSUPPORTED_SCHEME': 1000,
  206.   /**
  207.    * An HTTP network request returned an HTTP status that indicated a failure.
  208.    * <br> error.data[0] is the URI.
  209.    * <br> error.data[1] is the status code.
  210.    * <br> error.data[2] is the response text, or null if the response could not
  211.    *   be interpreted as text.
  212.    * <br> error.data[3] is the map of response headers.
  213.    * <br> error.data[4] is the NetworkingEngine.RequestType of the request,
  214.    *   if one was provided.
  215.    * <br> error.data[5] is the final URI. This may be different if the initial
  216.    *   URI (error.data[0]) issued a redirect.
  217.    */
  218.   'BAD_HTTP_STATUS': 1001,
  220.   /**
  221.    * An HTTP network request failed with an error, but not from the server.
  222.    * <br> error.data[0] is the URI.
  223.    * <br> error.data[1] is the original error.
  224.    * <br> error.data[2] is the NetworkingEngine.RequestType of the request.
  225.    */
  226.   'HTTP_ERROR': 1002,
  228.   /**
  229.    * A network request timed out.
  230.    * <br> error.data[0] is the URI.
  231.    * <br> error.data[1] is the NetworkingEngine.RequestType of the request,
  232.    *   if one was provided.
  233.    */
  234.   'TIMEOUT': 1003,
  236.   /**
  237.    * A network request was made with a malformed data URI.
  238.    * <br> error.data[0] is the URI.
  239.    */
  240.   'MALFORMED_DATA_URI': 1004,
  242.   // RETIRED: 'UNKNOWN_DATA_URI_ENCODING': 1005,
  244.   /**
  245.    * A request filter threw an error.
  246.    * <br> error.data[0] is the original error.
  247.    */
  248.   'REQUEST_FILTER_ERROR': 1006,
  250.   /**
  251.    * A response filter threw an error.
  252.    * <br> error.data[0] is the original error.
  253.    */
  254.   'RESPONSE_FILTER_ERROR': 1007,
  256.   /**
  257.    * A testing network request was made with a malformed URI.
  258.    * This error is only used by unit and integration tests.
  259.    */
  260.   'MALFORMED_TEST_URI': 1008,
  262.   /**
  263.    * An unexpected network request was made to the FakeNetworkingEngine.
  264.    * This error is only used by unit and integration tests.
  265.    */
  266.   'UNEXPECTED_TEST_REQUEST': 1009,
  268.   /**
  269.    * The number of retry attempts have run out.
  270.    * This is an internal error and shouldn't be propagated.
  271.    */
  272.   'ATTEMPTS_EXHAUSTED': 1010,
  274.   /**
  275.    * The segment is missing.
  276.    * <br> error.data[0] is the URI.
  277.    */
  278.   'SEGMENT_MISSING': 1011,
  281.   /** The text parser failed to parse a text stream due to an invalid header. */
  282.   'INVALID_TEXT_HEADER': 2000,
  284.   /**
  285.    * The text parser failed to parse a text stream due to an invalid cue.
  286.    * <br> error.data[0] is extra context, if available.
  287.    */
  288.   'INVALID_TEXT_CUE': 2001,
  290.   // RETIRED: 'INVALID_TEXT_SETTINGS': 2002,
  292.   /**
  293.    * Was unable to detect the encoding of the response text.  Suggest adding
  294.    * byte-order-markings to the response data.
  295.    */
  296.   'UNABLE_TO_DETECT_ENCODING': 2003,
  298.   /** The response data contains invalid Unicode character encoding. */
  299.   'BAD_ENCODING': 2004,
  301.   /**
  302.    * The XML parser failed to parse an xml stream, or the XML lacks mandatory
  303.    * elements for TTML.
  304.    * <br> error.data[0] is extra context, if available.
  305.    */
  306.   'INVALID_XML': 2005,
  308.   // RETIRED: 'INVALID_TTML': 2006,
  310.   /**
  311.    * MP4 segment does not contain TTML.
  312.    */
  313.   'INVALID_MP4_TTML': 2007,
  315.   /**
  316.    * MP4 segment does not contain VTT.
  317.    */
  318.   'INVALID_MP4_VTT': 2008,
  320.   /**
  321.    * When examining media in advance, we were unable to extract the cue time.
  322.    * This should only be possible with HLS, where we do not have explicit
  323.    * segment start times.
  324.    * <br> error.data[0] is the underlying exception or Error object.
  325.    */
  326.   'UNABLE_TO_EXTRACT_CUE_START_TIME': 2009,
  328.   /**
  329.    * MP4 segment for CEA data is invalid.
  330.    */
  331.   'INVALID_MP4_CEA': 2010,
  333.   /**
  334.    * Unable to guess mime type of the text.
  335.    * <br> error.data[0] is the text file's uri.
  336.    */
  337.   'TEXT_COULD_NOT_GUESS_MIME_TYPE': 2011,
  339.   /**
  340.    * External text tracks cannot be added in src= because native platform
  341.    * doesn't support it.
  342.    */
  343.   'CANNOT_ADD_EXTERNAL_TEXT_TO_SRC_EQUALS': 2012,
  345.   /**
  346.    * Only WebVTT is supported when using src=.
  347.    * <br> error.data[0] is the text MIME type.
  348.    */
  349.   'TEXT_ONLY_WEBVTT_SRC_EQUALS': 2013,
  351.   /**
  352.    * The compilation does not contain a required text plugin for this
  353.    * operation.
  354.    * <br> error.data[0] is the text MIME type.
  355.    */
  356.   'MISSING_TEXT_PLUGIN': 2014,
  358.   // RETIRED: 'CHAPTERS_TRACK_FAILED': 2015,
  360.   // RETIRED: 'CANNOT_ADD_EXTERNAL_THUMBNAILS_TO_SRC_EQUALS': 2016,
  362.   /**
  363.    * Only external urls of WebVTT type are supported.
  364.    * <br> error.data[0] is the uri.
  365.    */
  366.   'UNSUPPORTED_EXTERNAL_THUMBNAILS_URI': 2017,
  368.   /**
  369.    * Some component tried to read past the end of a buffer.  The segment index,
  370.    * init segment, or PSSH may be malformed.
  371.    */
  372.   'BUFFER_READ_OUT_OF_BOUNDS': 3000,
  374.   /**
  375.    * Some component tried to parse an integer that was too large to fit in a
  376.    * JavaScript number without rounding error.  JavaScript can only natively
  377.    * represent integers up to 53 bits.
  378.    */
  379.   'JS_INTEGER_OVERFLOW': 3001,
  381.   /**
  382.    * The EBML parser used to parse the WebM container encountered an integer,
  383.    * ID, or other field larger than the maximum supported by the parser.
  384.    */
  385.   'EBML_OVERFLOW': 3002,
  387.   /**
  388.    * The EBML parser used to parse the WebM container encountered a floating-
  389.    * point field of a size not supported by the parser.
  390.    */
  391.   'EBML_BAD_FLOATING_POINT_SIZE': 3003,
  393.   /**
  394.    * The MP4 SIDX parser found the wrong box type.
  395.    * Either the segment index range is incorrect or the data is corrupt.
  396.    */
  397.   'MP4_SIDX_WRONG_BOX_TYPE': 3004,
  399.   /**
  400.    * The MP4 SIDX parser encountered an invalid timescale.
  401.    * The segment index data may be corrupt.
  402.    */
  403.   'MP4_SIDX_INVALID_TIMESCALE': 3005,
  405.   /** The MP4 SIDX parser encountered a type of SIDX that is not supported. */
  406.   'MP4_SIDX_TYPE_NOT_SUPPORTED': 3006,
  408.   /**
  409.    * The WebM Cues parser was unable to locate the Cues element.
  410.    * The segment index data may be corrupt.
  411.    */
  412.   'WEBM_CUES_ELEMENT_MISSING': 3007,
  414.   /**
  415.    * The WebM header parser was unable to locate the Ebml element.
  416.    * The init segment data may be corrupt.
  417.    */
  418.   'WEBM_EBML_HEADER_ELEMENT_MISSING': 3008,
  420.   /**
  421.    * The WebM header parser was unable to locate the Segment element.
  422.    * The init segment data may be corrupt.
  423.    */
  424.   'WEBM_SEGMENT_ELEMENT_MISSING': 3009,
  426.   /**
  427.    * The WebM header parser was unable to locate the Info element.
  428.    * The init segment data may be corrupt.
  429.    */
  430.   'WEBM_INFO_ELEMENT_MISSING': 3010,
  432.   /**
  433.    * The WebM header parser was unable to locate the Duration element.
  434.    * The init segment data may be corrupt or may have been incorrectly encoded.
  435.    * Shaka requires a duration in WebM DASH content.
  436.    */
  437.   'WEBM_DURATION_ELEMENT_MISSING': 3011,
  439.   /**
  440.    * The WebM Cues parser was unable to locate the Cue Track Positions element.
  441.    * The segment index data may be corrupt.
  442.    */
  443.   'WEBM_CUE_TRACK_POSITIONS_ELEMENT_MISSING': 3012,
  445.   /**
  446.    * The WebM Cues parser was unable to locate the Cue Time element.
  447.    * The segment index data may be corrupt.
  448.    */
  449.   'WEBM_CUE_TIME_ELEMENT_MISSING': 3013,
  451.   /**
  452.    * A MediaSource operation failed.
  453.    * <br> error.data[0] is a MediaError code from the video element.
  454.    * <br> error.data[1] is the segment URI that triggered the error, if any.
  455.    */
  456.   'MEDIA_SOURCE_OPERATION_FAILED': 3014,
  458.   /**
  459.    * A MediaSource operation threw an exception.
  460.    * <br> error.data[0] is the exception that was thrown.
  461.    * <br> error.data[1] is the error object from the video element.
  462.    * <br> error.data[2] is the segment URI that triggered the error, if any.
  463.    */
  464.   'MEDIA_SOURCE_OPERATION_THREW': 3015,
  466.   /**
  467.    * The video element reported an error.
  468.    * <br> error.data[0] is a MediaError code from the video element.
  469.    * <br> On Edge, error.data[1] is a Microsoft extended error code in hex.
  470.    * <br> On Chrome, error.data[2] is a string with details on the error.
  471.    * <br> See top of file for links to browser error codes.
  472.    */
  473.   'VIDEO_ERROR': 3016,
  475.   /**
  476.    * A MediaSource operation threw QuotaExceededError and recovery failed. The
  477.    * content cannot be played correctly because the segments are too large for
  478.    * the browser/platform. This may occur when attempting to play very high
  479.    * quality, very high bitrate content on low-end devices.
  480.    * <br> error.data[0] is the type of content which caused the error.
  481.    */
  482.   'QUOTA_EXCEEDED_ERROR': 3017,
  484.   /**
  485.    * Transmuxing with our internal transmuxer failed.
  486.    * <br> error.data[0] is the segment URI that triggered the error, if any.
  487.    */
  488.   'TRANSMUXING_FAILED': 3018,
  490.   /**
  491.    * Content transformations required by the platform could not be performed for
  492.    * some reason (unsupported container, etc.)
  493.    * <br> @see https://github.com/shaka-project/shaka-player/issues/2759
  494.    * <br> error.data[0] is the segment URI that triggered the error, if any.
  495.    */
  496.   'CONTENT_TRANSFORMATION_FAILED': 3019,
  498.   /**
  499.    * Important data is missing to be able to do the transmuxing of MSS.
  500.    * <br> error.data[0] is the segment URI that triggered the error, if any.
  501.    */
  502.   'MSS_MISSING_DATA_FOR_TRANSMUXING': 3020,
  504.   // RETIRED: 'MSS_TRANSMUXING_CODEC_UNKNOWN': 3021,
  506.   /**
  507.    * MSS transmuxing failed for unknown reason.
  508.    * <br> error.data[0] is the segment URI that triggered the error, if any.
  509.    */
  510.   'MSS_TRANSMUXING_FAILED': 3022,
  512.   /**
  513.    * An internal error which indicates that transmuxing operation has no video
  514.    * data. This should not be seen by applications.
  515.    * <br> error.data[0] is the segment URI that triggered the error, if any.
  516.    */
  517.   'TRANSMUXING_NO_VIDEO_DATA': 3023,
  519.   /**
  520.    * A MediaSource operation is not allowed because the streaming is not
  521.    * allowed.
  522.    * <br> error.data[0] is the type of content which caused the error.
  523.    */
  524.   'STREAMING_NOT_ALLOWED': 3024,
  527.   /**
  528.    * The Player was unable to guess the manifest type based on file extension
  529.    * or MIME type.  To fix, try one of the following:
  530.    * <br><ul>
  531.    *   <li>Rename the manifest so that the URI ends in a well-known extension.
  532.    *   <li>Configure the server to send a recognizable Content-Type header.
  533.    *   <li>Configure the server to accept a HEAD request for the manifest.
  534.    * </ul>
  535.    * <br> error.data[0] is the manifest URI.
  536.    * <br> error.data[1] is the detected or specified MIME type.
  537.    */
  538.   'UNABLE_TO_GUESS_MANIFEST_TYPE': 4000,
  540.   /**
  541.    * The DASH Manifest contained invalid XML markup.
  542.    * <br> error.data[0] is the URI associated with the XML.
  543.    */
  544.   'DASH_INVALID_XML': 4001,
  546.   /**
  547.    * The DASH Manifest contained a Representation with insufficient segment
  548.    * information.
  549.    */
  550.   'DASH_NO_SEGMENT_INFO': 4002,
  552.   /** The DASH Manifest contained an AdaptationSet with no Representations. */
  553.   'DASH_EMPTY_ADAPTATION_SET': 4003,
  555.   /** The DASH Manifest contained an Period with no AdaptationSets. */
  556.   'DASH_EMPTY_PERIOD': 4004,
  558.   /**
  559.    * The DASH Manifest does not specify an init segment with a WebM container.
  560.    */
  561.   'DASH_WEBM_MISSING_INIT': 4005,
  563.   /** The DASH Manifest contained an unsupported container format. */
  564.   'DASH_UNSUPPORTED_CONTAINER': 4006,
  566.   /** The embedded PSSH data has invalid encoding. */
  567.   'DASH_PSSH_BAD_ENCODING': 4007,
  569.   /**
  570.    * There is an AdaptationSet whose Representations do not have any common
  571.    * key-systems.
  572.    */
  573.   'DASH_NO_COMMON_KEY_SYSTEM': 4008,
  575.   /** Having multiple key IDs per Representation is not supported. */
  576.   'DASH_MULTIPLE_KEY_IDS_NOT_SUPPORTED': 4009,
  578.   /** The DASH Manifest specifies conflicting key IDs. */
  579.   'DASH_CONFLICTING_KEY_IDS': 4010,
  581.   // RETIRED: 'UNPLAYABLE_PERIOD': 4011,
  583.   /**
  584.    * There exist some streams that could be decoded, but restrictions imposed
  585.    * by the application or the key system prevent us from playing.  This may
  586.    * happen under the following conditions:
  587.    * <ul>
  588.    *   <li>The application has given restrictions to the Player that restrict
  589.    *       at least one content type completely (e.g. no playable audio).
  590.    *   <li>The manifest specifies different keys than were given to us from the
  591.    *       license server.
  592.    *   <li>The key system has imposed output restrictions that cannot be met
  593.    *       (such as HDCP) and there are no unrestricted alternatives.
  594.    * </ul>
  595.    * <br> error.data[0] is a {@link shaka.extern.RestrictionInfo} object
  596.    * describing the kinds of restrictions that caused this error.
  597.    */
  598.   'RESTRICTIONS_CANNOT_BE_MET': 4012,
  600.   // RETIRED: 'INTERNAL_ERROR_KEY_STATUS': 4013,
  602.   // RETIRED: 'NO_PERIODS': 4014,
  604.   /**
  605.    * HLS playlist doesn't start with a mandatory #EXTM3U tag.
  606.    */
  607.   'HLS_PLAYLIST_HEADER_MISSING': 4015,
  609.   /**
  610.    * HLS tag has an invalid name that doesn't start with '#EXT'
  611.    * <br> error.data[0] is the invalid tag.
  612.    */
  613.   'INVALID_HLS_TAG': 4016,
  615.   /**
  616.    * HLS playlist has both Master and Media/Segment tags.
  617.    */
  618.   'HLS_INVALID_PLAYLIST_HIERARCHY': 4017,
  620.   /**
  621.    * A Representation has an id that is the same as another Representation in
  622.    * the same Period.  This makes manifest updates impossible since we cannot
  623.    * map the updated Representation to the old one.
  624.    */
  625.   'DASH_DUPLICATE_REPRESENTATION_ID': 4018,
  627.   // RETIRED: 'HLS_MEDIA_INIT_SECTION_INFO_MISSING': 4019,
  629.   /**
  630.    * HLS manifest has several #EXT-X-MAP tags. We can only
  631.    * support one at the moment.
  632.    */
  633.   'HLS_MULTIPLE_MEDIA_INIT_SECTIONS_FOUND': 4020,
  635.   // RETIRED: 'HLS_COULD_NOT_GUESS_MIME_TYPE': 4021,
  637.   // RETIRED: 'HLS_MASTER_PLAYLIST_NOT_PROVIDED': 4022,
  639.   /**
  640.    * One of the required attributes was not provided, so the
  641.    * HLS manifest is invalid.
  642.    * <br> error.data[0] is the missing attribute's name.
  643.    */
  644.   'HLS_REQUIRED_ATTRIBUTE_MISSING': 4023,
  646.   /**
  647.    * One of the required tags was not provided, so the
  648.    * HLS manifest is invalid.
  649.    * <br> error.data[0] is the missing tag's name.
  650.    */
  651.   'HLS_REQUIRED_TAG_MISSING': 4024,
  653.   /**
  654.    * The HLS parser was unable to guess codecs of a stream.
  655.    * <br> error.data[0] is the list of all codecs for the variant.
  656.    */
  657.   'HLS_COULD_NOT_GUESS_CODECS': 4025,
  659.   /**
  660.    * The HLS parser has encountered encrypted content with unsupported
  661.    * KEYFORMAT attributes.
  662.    */
  663.   'HLS_KEYFORMATS_NOT_SUPPORTED': 4026,
  665.   /**
  666.    * The manifest parser only supports xlink links with xlink:actuate="onLoad".
  667.    */
  668.   'DASH_UNSUPPORTED_XLINK_ACTUATE': 4027,
  670.   /**
  671.    * The manifest parser has hit its depth limit on xlink link chains.
  672.    */
  673.   'DASH_XLINK_DEPTH_LIMIT': 4028,
  675.   // RETIRED: 'HLS_LIVE_CONTENT_NOT_SUPPORTED': 4029,
  677.   // RETIRED: 'HLS_COULD_NOT_PARSE_SEGMENT_START_TIME': 4030,
  679.   // RETIRED: 'HLS_MEDIA_SEQUENCE_REQUIRED_IN_LIVE_STREAMS': 4031,
  681.   /**
  682.    * The content container or codecs are not supported by this browser. For
  683.    * example, this could happen if the content is WebM, but your browser does
  684.    * not support the WebM container, or if the content uses HEVC, but your
  685.    * browser does not support the HEVC codec.  This can also occur for
  686.    * multi codec or multi container manifests if none of the codecs
  687.    * or containers are supported by the browser.
  688.    *
  689.    * To see what your browser supports, you can check the JSON data dumped by
  690.    * http://support.shaka-player-demo.appspot.com/
  691.    */
  692.   'CONTENT_UNSUPPORTED_BY_BROWSER': 4032,
  694.   /**
  695.    * External text tracks cannot be added to live streams.
  696.    */
  697.   'CANNOT_ADD_EXTERNAL_TEXT_TO_LIVE_STREAM': 4033,
  699.   // RETIRED: 'HLS_AES_128_ENCRYPTION_NOT_SUPPORTED': 4034,
  700.   // RETIRED: 'HLS_INTERNAL_SKIP_STREAM': 4035,
  702.   /** The Manifest contained no Variants. */
  703.   'NO_VARIANTS': 4036,
  705.   /**
  706.    * We failed to find matching streams across DASH Periods, and the
  707.    * period-flattening algorithm introduced in v3.0 has failed.
  708.    */
  709.   'PERIOD_FLATTENING_FAILED': 4037,
  711.   /**
  712.    * We failed to find matching streams across DASH Periods due to inconsistent
  713.    * DRM systems across periods.
  714.    */
  715.   'INCONSISTENT_DRM_ACROSS_PERIODS': 4038,
  717.   /**
  718.    * The HLS manifest refers to an undeclared variables.
  719.    * <br> error.data[0] is the variable undeclared.
  720.    */
  721.   'HLS_VARIABLE_NOT_FOUND': 4039,
  723.   /**
  724.    * We do not support playing encrypted mp2t with MSE
  725.    */
  726.   'HLS_MSE_ENCRYPTED_MP2T_NOT_SUPPORTED': 4040,
  728.   /**
  729.    * We do not support playing encrypted content (different than mp2t) with MSE
  730.    * and legacy Apple MediaKeys API.
  731.    */
  732.   'HLS_MSE_ENCRYPTED_LEGACY_APPLE_MEDIA_KEYS_NOT_SUPPORTED': 4041,
  734.   /**
  735.    * Web Crypto API is not available (to decrypt AES-128 streams). Web Crypto
  736.    * only exists in secure origins like https.
  737.    */
  738.   'NO_WEB_CRYPTO_API': 4042,
  740.   // RETIRED: 'HLS_AES_128_INVALID_IV_LENGTH': 4043,
  741.   // RETIRED: 'HLS_AES_128_INVALID_KEY_LENGTH': 4044,
  743.   /**
  744.    * External thumbnails tracks cannot be added to live streams.
  745.    */
  746.   'CANNOT_ADD_EXTERNAL_THUMBNAILS_TO_LIVE_STREAM': 4045,
  748.   /**
  749.    * The MSS Manifest contained invalid XML markup.
  750.    * <br> error.data[0] is the URI associated with the XML.
  751.    */
  752.   'MSS_INVALID_XML': 4046,
  754.   /**
  755.    * MSS parser encountered a live playlist.
  756.    */
  757.   'MSS_LIVE_CONTENT_NOT_SUPPORTED': 4047,
  759.   /**
  760.    * AES-128 iv length should be 16 bytes.
  761.    */
  762.   'AES_128_INVALID_IV_LENGTH': 4048,
  764.   /**
  765.    * AES-128 encryption key length should be 16 bytes.
  766.    */
  767.   'AES_128_INVALID_KEY_LENGTH': 4049,
  769.   /**
  770.    * The DASH Manifest specifies conflicting AES-128 keys.
  771.    */
  772.   'DASH_CONFLICTING_AES_128': 4050,
  774.   /**
  775.    * The DASH Manifest specifies a unsupported AES-128 encryption.
  776.    */
  777.   'DASH_UNSUPPORTED_AES_128': 4051,
  779.   /**
  780.    * Patch requested during an update did not match original manifest.
  781.    */
  782.   'DASH_INVALID_PATCH': 4052,
  784.   /**
  785.    * The media playlist has not segments or all segments are gap.
  786.    */
  787.   'HLS_EMPTY_MEDIA_PLAYLIST': 4053,
  789.   /**
  790.    * We do not support playing encrypted content with MSE
  791.    * and legacy Apple MediaKeys API.
  792.    */
  793.   'DASH_MSE_ENCRYPTED_LEGACY_APPLE_MEDIA_KEYS_NOT_SUPPORTED': 4054,
  795.   /**
  796.    * External chapters cannot be added to live streams.
  797.    */
  798.   'CANNOT_ADD_EXTERNAL_CHAPTERS_TO_LIVE_STREAM': 4054,
  800.   // RETIRED: 'INCONSISTENT_BUFFER_STATE': 5000,
  801.   // RETIRED: 'INVALID_SEGMENT_INDEX': 5001,
  802.   // RETIRED: 'SEGMENT_DOES_NOT_EXIST': 5002,
  803.   // RETIRED: 'CANNOT_SATISFY_BYTE_LIMIT': 5003,
  804.   // RETIRED: 'BAD_SEGMENT': 5004,
  805.   // RETIRED: 'INVALID_STREAMS_CHOSEN': 5005,
  807.   /**
  808.    * This would only happen if StreamingEngine were not started correctly, and
  809.    * should not be seen in production.
  810.    */
  811.   'STREAMING_ENGINE_STARTUP_INVALID_STATE': 5006,
  814.   /**
  815.    * The manifest indicated protected content, but the manifest parser was
  816.    * unable to determine what key systems should be used.
  817.    */
  818.   'NO_RECOGNIZED_KEY_SYSTEMS': 6000,
  820.   /**
  821.    * None of the requested key system configurations are available.  This may
  822.    * happen under the following conditions:
  823.    * <ul>
  824.    *   <li> The key system is not supported.
  825.    *   <li> The key system does not support the features requested (e.g.
  826.    *        persistent state).
  827.    *   <li> A user prompt was shown and the user denied access.
  828.    *   <li> The key system is not available from unsecure contexts. (i.e.
  829.             requires HTTPS) See https://bit.ly/2K9X1nY
  830.    * </ul>
  831.    */
  832.   'REQUESTED_KEY_SYSTEM_CONFIG_UNAVAILABLE': 6001,
  834.   /**
  835.    * The browser found one of the requested key systems, but it failed to
  836.    * create an instance of the CDM for some unknown reason.
  837.    * <br> error.data[0] is an error message string from the browser.
  838.    */
  839.   'FAILED_TO_CREATE_CDM': 6002,
  841.   /**
  842.    * The browser found one of the requested key systems and created an instance
  843.    * of the CDM, but it failed to attach the CDM to the video for some unknown
  844.    * reason.
  845.    * <br> error.data[0] is an error message string from the browser.
  846.    */
  847.   'FAILED_TO_ATTACH_TO_VIDEO': 6003,
  849.   /**
  850.    * The CDM rejected the server certificate supplied by the application.
  851.    * The certificate may be malformed or in an unsupported format.
  852.    * <br> error.data[0] is an error message string from the browser.
  853.    */
  854.   'INVALID_SERVER_CERTIFICATE': 6004,
  856.   /**
  857.    * The CDM refused to create a session for some unknown reason.
  858.    * <br> error.data[0] is an error message string from the browser.
  859.    */
  860.   'FAILED_TO_CREATE_SESSION': 6005,
  862.   /**
  863.    * The CDM was unable to generate a license request for the init data it was
  864.    * given.  The init data may be malformed or in an unsupported format.
  865.    * <br> error.data[0] is an error message string from the browser.
  866.    * <br> error.data[1] is the error object from the browser.
  867.    * <br> error.data[2] is a string with the extended error code, if available.
  868.    * <br> See top of file for links to browser error codes.
  869.    */
  870.   'FAILED_TO_GENERATE_LICENSE_REQUEST': 6006,
  872.   /**
  873.    * The license request failed.  This could be a timeout, a network failure, or
  874.    * a rejection by the server.
  875.    * <br> error.data[0] is a shaka.util.Error from the networking engine.
  876.    */
  877.   'LICENSE_REQUEST_FAILED': 6007,
  879.   /**
  880.    * The license response was rejected by the CDM.  The server's response may be
  881.    * invalid or malformed for this CDM.
  882.    * <br> error.data[0] is an error message string from the browser.
  883.    * <br> See top of file for links to browser error codes.
  884.    */
  885.   'LICENSE_RESPONSE_REJECTED': 6008,
  887.   // RETIRED: 'NO_LICENSE_SERVER_SPECIFIED': 6009,
  889.   /**
  890.    * The manifest does not specify any DRM info, but the content is encrypted.
  891.    * Either the manifest or the manifest parser are broken.
  892.    */
  893.   'ENCRYPTED_CONTENT_WITHOUT_DRM_INFO': 6010,
  895.   // RETIRED: 'WRONG_KEYS': 6011,
  897.   /**
  898.    * No license server was given for the key system signaled by the manifest.
  899.    * A license server URI is required for every key system.
  900.    * <br> error.data[0] is the key system identifier.
  901.    */
  902.   'NO_LICENSE_SERVER_GIVEN': 6012,
  904.   /**
  905.    * A required offline session was removed. The content might not be playable
  906.    * depending of the playback context.
  907.    */
  908.   'OFFLINE_SESSION_REMOVED': 6013,
  910.   /**
  911.    * The license has expired.  This is triggered when all keys in the key
  912.    * status map have a status of 'expired'.
  913.    */
  914.   'EXPIRED': 6014,
  916.   /**
  917.    * A server certificate wasn't given when it is required.  FairPlay requires
  918.    * setting an explicit server certificate in the configuration.
  919.    */
  920.   'SERVER_CERTIFICATE_REQUIRED': 6015,
  922.   /**
  923.    * An error was thrown while executing the init data transformation.
  924.    * <br> error.data[0] is the original error.
  925.    */
  926.   'INIT_DATA_TRANSFORM_ERROR': 6016,
  928.   /**
  929.    * The server certificate request failed.
  930.    * <br> error.data[0] is a shaka.util.Error from the networking engine.
  931.    */
  932.   'SERVER_CERTIFICATE_REQUEST_FAILED': 6017,
  934.   /**
  935.    * The HDCP version does not meet the requirements.
  936.    */
  937.   'MIN_HDCP_VERSION_NOT_MATCH': 6018,
  939.   /**
  940.    * Error when checking HDCP version.
  941.    * <br> error.data[0] is an error message string from the browser.
  942.    */
  943.   'ERROR_CHECKING_HDCP_VERSION': 6019,
  945.   /**
  946.    * The browser does not support EME APIs, so DRM content cannot be played.
  947.    */
  948.   'MISSING_EME_SUPPORT': 6020,
  951.   /**
  952.    * The call to Player.load() was interrupted by a call to Player.unload()
  953.    * or another call to Player.load().
  954.    */
  955.   'LOAD_INTERRUPTED': 7000,
  957.   /**
  958.    * An internal error which indicates that an operation was aborted.  This
  959.    * should not be seen by applications.
  960.    */
  961.   'OPERATION_ABORTED': 7001,
  963.   /**
  964.    * The call to Player.load() failed because the Player does not have a video
  965.    * element.  The video element must either be provided to the constructor or
  966.    * to Player.attach() before Player.load() is called.
  967.    */
  968.   'NO_VIDEO_ELEMENT': 7002,
  970.   /**
  971.    * The operation failed because the object has been destroyed.
  972.    */
  973.   'OBJECT_DESTROYED': 7003,
  975.   /**
  976.    * The content has not been loaded in the Player.
  977.    */
  978.   'CONTENT_NOT_LOADED': 7004,
  980.   /**
  981.    * The call to preload failed, due to being called on src= content.
  982.    */
  983.   'SRC_EQUALS_PRELOAD_NOT_SUPPORTED': 7005,
  985.   /**
  986.    * The operation failed because the preload has been destroyed. This can
  987.    * happen by reusing the same preload in multiple load calls.
  988.    */
  989.   'PRELOAD_DESTROYED': 7006,
  991.   /**
  992.    * The Cast API is unavailable.  This may be because of one of the following:
  993.    *  1. The browser may not have Cast support
  994.    *  2. The browser may be missing a necessary Cast extension
  995.    *  3. The Cast sender library may not be loaded in your app
  996.    */
  997.   'CAST_API_UNAVAILABLE': 8000,
  999.   /**
  1000.    * No cast receivers are available at this time.
  1001.    */
  1002.   'NO_CAST_RECEIVERS': 8001,
  1004.   /**
  1005.    * The library is already casting.
  1006.    */
  1007.   'ALREADY_CASTING': 8002,
  1009.   /**
  1010.    * A Cast SDK error that we did not explicitly plan for has occurred.
  1011.    * Check data[0] and refer to the Cast SDK documentation for details.
  1012.    * <br> error.data[0] is an error object from the Cast SDK.
  1013.    */
  1014.   'UNEXPECTED_CAST_ERROR': 8003,
  1016.   /**
  1017.    * The cast operation was canceled by the user.
  1018.    * <br> error.data[0] is an error object from the Cast SDK.
  1019.    */
  1020.   'CAST_CANCELED_BY_USER': 8004,
  1022.   /**
  1023.    * The cast connection timed out.
  1024.    * <br> error.data[0] is an error object from the Cast SDK.
  1025.    */
  1026.   'CAST_CONNECTION_TIMED_OUT': 8005,
  1028.   /**
  1029.    * The requested receiver app ID does not exist or is unavailable.
  1030.    * Check the requested app ID for typos.
  1031.    * <br> error.data[0] is an error object from the Cast SDK.
  1032.    */
  1033.   'CAST_RECEIVER_APP_UNAVAILABLE': 8006,
  1036.   // RETIRED: CAST_RECEIVER_APP_ID_MISSING': 8007,
  1039.   /**
  1040.    * Offline storage is not supported on this browser; it is required for
  1041.    * offline support.
  1042.    */
  1043.   'STORAGE_NOT_SUPPORTED': 9000,
  1045.   /**
  1046.    * An unknown error occurred in the IndexedDB.
  1047.    * <br> On Firefox, one common source for UnknownError calls is reverting
  1048.    * Firefox to an old version. This makes the IndexedDB storage inaccessible
  1049.    * for older versions. The only way to fix this is to delete the storage
  1050.    * data in your profile. See https://mzl.la/2yCGWCm
  1051.    * <br> error.data[0] is the error object.
  1052.    */
  1053.   'INDEXED_DB_ERROR': 9001,
  1055.   /**
  1056.    * The storage operation was aborted.  Deprecated in favor of more general
  1057.    * OPERATION_ABORTED.
  1058.    */
  1059.   'DEPRECATED_OPERATION_ABORTED': 9002,
  1061.   /**
  1062.    * The specified item was not found in the IndexedDB.
  1063.    * <br> error.data[0] is the offline URI.
  1064.    */
  1065.   'REQUESTED_ITEM_NOT_FOUND': 9003,
  1067.   /**
  1068.    * A network request was made with a malformed offline URI.
  1069.    * <br> error.data[0] is the URI.
  1070.    */
  1071.   'MALFORMED_OFFLINE_URI': 9004,
  1073.   /**
  1074.    * The specified content is live or in-progress.
  1075.    * Live and in-progress streams cannot be stored offline.
  1076.    * <br> error.data[0] is the URI.
  1077.    */
  1078.   'CANNOT_STORE_LIVE_OFFLINE': 9005,
  1080.   // RETIRED: 'STORE_ALREADY_IN_PROGRESS': 9006,
  1082.   /**
  1083.    * There was no init data available for offline storage.  This happens when
  1084.    * there is no init data in the manifest nor could we find any in the
  1085.    * segments.  We currently only support searching MP4 init segments for init
  1086.    * data.
  1087.    */
  1088.   'NO_INIT_DATA_FOR_OFFLINE': 9007,
  1090.   /**
  1091.    * shaka.offline.Storage was constructed with a Player proxy instead of a
  1092.    * local player instance.  To fix this, use Player directly with Storage
  1093.    * instead of the results of CastProxy.prototype.getPlayer().
  1094.    */
  1095.   'LOCAL_PLAYER_INSTANCE_REQUIRED': 9008,
  1097.   // RETIRED/MOVED TO 4000's: 'CONTENT_UNSUPPORTED_BY_BROWSER': 9009,
  1099.   // RETIRED: 'UNSUPPORTED_UPGRADE_REQUEST': 9010,
  1101.   /**
  1102.    * The storage cell does not allow new operations that require new keys.
  1103.    */
  1104.   'NEW_KEY_OPERATION_NOT_SUPPORTED': 9011,
  1106.   /**
  1107.    * A key was not found in a storage cell.
  1108.    */
  1109.   'KEY_NOT_FOUND': 9012,
  1111.   /**
  1112.    * A storage cell was not found.
  1113.    */
  1114.   'MISSING_STORAGE_CELL': 9013,
  1116.   /**
  1117.    * The storage limit defined in <code>downloadSizeCallback</code> has been
  1118.    * reached.
  1119.    */
  1120.   'STORAGE_LIMIT_REACHED': 9014,
  1122.   /**
  1123.    * <code>downloadSizeCallback</code> has produced an unexpected error.
  1124.    */
  1125.   'DOWNLOAD_SIZE_CALLBACK_ERROR': 9015,
  1127.   /**
  1128.    * The storage cell does not allow new operations that significantly change
  1129.    * existing data.
  1130.    */
  1131.   'MODIFY_OPERATION_NOT_SUPPORTED': 9016,
  1133.   /**
  1134.    * When attempting to open an indexedDB instance, nothing happened for long
  1135.    * enough for us to time out.  This keeps the storage mechanism from hanging
  1136.    * indefinitely, if neither the success nor error callbacks are called.
  1137.    */
  1138.   'INDEXED_DB_INIT_TIMED_OUT': 9017,
  1140.   /**
  1141.    * CS IMA SDK, required for ad insertion, has not been included on the page.
  1142.    */
  1143.   'CS_IMA_SDK_MISSING': 10000,
  1145.   /**
  1146.    * Client Side Ad Manager needs to be initialized to enable Client Side
  1147.    * Ad Insertion. Call adManager.initClientSide() to do it.
  1148.    */
  1149.   'CS_AD_MANAGER_NOT_INITIALIZED': 10001,
  1151.   /**
  1152.    * SS IMA SDK, required for ad insertion, has not been included on the page.
  1153.    */
  1154.   'SS_IMA_SDK_MISSING': 10002,
  1156.   /**
  1157.    * Server Side Ad Manager needs to be initialized to enable Server Side
  1158.    * Ad Insertion. Call adManager.initServerSide() to do it.
  1159.    */
  1160.   'SS_AD_MANAGER_NOT_INITIALIZED': 10003,
  1162.   /**
  1163.    * A new DAI steam was requested before the previous request had been
  1164.    * resolved. Only one stream request at a time is supported. Please wait
  1165.    * for the previous request to complete before initiating a new one.
  1166.    */
  1167.   'CURRENT_DAI_REQUEST_NOT_FINISHED': 10004,
  1169.   /**
  1170.    * MediaTailor Ad Manager needs to be initialized to enable MediaTailor
  1171.    * Ad Insertion. Call adManager.initMediaTailor() to do it.
  1172.    */
  1173.   'MT_AD_MANAGER_NOT_INITIALIZED': 10005,
  1175.   /**
  1176.    * Interstitial Ad Manager needs to be initialized to enable interstitial
  1177.    * Ad Insertion. Call adManager.initInterstitial() to do it.
  1178.    */
  1179.   'INTERSTITIAL_AD_MANAGER_NOT_INITIALIZED': 10006,
  1181.   /**
  1182.    * The VAST contained invalid XML markup.
  1183.    */
  1184.   'VAST_INVALID_XML': 10007,
  1185. };