MediaError:code 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

只讀屬性 MediaError.code 返回一個數值,該數值表示媒體元素上發生的錯誤的型別。要獲取包含具體診斷資訊的文字字串,請參閱 MediaError.message

一個表示發生的錯誤通用型別的數值。可能的值將在 Media 錯誤程式碼常量 中進行描述。

Media 錯誤程式碼常量

名稱 描述
MEDIA_ERR_ABORTED 1 關聯資源的獲取已由使用者請求中止。
MEDIA_ERR_NETWORK 2 發生某種網路錯誤,導致媒體無法成功獲取,儘管它以前是可用的。
MEDIA_ERR_DECODE 3 儘管以前已確定該媒體資源可用,但在嘗試解碼時發生錯誤,從而導致了錯誤。
MEDIA_ERR_SRC_NOT_SUPPORTED 4 發現關聯的資源或媒體提供者物件(例如 MediaStream)不合適。

示例

此示例建立了一個 <video> 元素,為其設定了錯誤處理程式,然後將該元素的 src 屬性設定為要在元素中顯示的影片資源。錯誤處理程式會輸出一條訊息

js
const obj = document.createElement("video");
obj.onerror = () => {
  console.error(`Error with media: ${obj.error.code}`);
};
obj.src = "https://example.com/blahblah.mp4";

規範

規範
HTML
# dom-mediaerror-code-dev

瀏覽器相容性

另見

  • MediaError:用於定義 MediaError.code 屬性的介面