HTMLElement:error 事件

當資源未能載入或無法使用時,會在元素上觸發 error 事件。例如,如果指令碼出現執行錯誤,或者找不到影像或影像無效。

此事件不可取消,也不會冒泡。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("error", (event) => { })

onerror = (event) => { }

事件型別

如果事件是由使用者介面元素生成的,則事件物件是 UIEvent 例項;否則,則是 Event 例項。

Event UIEvent

示例

即時示例

HTML

html
<div class="controls">
  <button id="img-error" type="button">Generate image error</button>
  <img class="bad-img" />
</div>

<div class="event-log">
  <label for="eventLog">Event log:</label>
  <textarea
    readonly
    class="event-log-contents"
    rows="8"
    cols="30"
    id="eventLog"></textarea>
</div>

JavaScript

js
const log = document.querySelector(".event-log-contents");

const badImg = document.querySelector(".bad-img");
badImg.addEventListener("error", (event) => {
  log.textContent += `${event.type}: Loading image\n`;
  console.log(event);
});

const imgError = document.querySelector("#img-error");
imgError.addEventListener("click", () => {
  badImg.setAttribute("src", "i-dont-exist");
});

結果

規範

規範
UI 事件
# event-type-error
HTML
# 事件-錯誤

瀏覽器相容性

另見

  • 相關事件
    • Window:error 事件
    • HTMLElement:load 事件