此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

webRequest.StreamFilter.onerror

当错误发生时调用的事件处理器。通常发生在传递给 webRequest.filterResponseData() 的请求 ID 无效时。

触发此事件后,webRequest.StreamFilter.error 属性将包含有关错误的更多信息的消息。

请注意,此事件会因网络错误而触发。

浏览器兼容性

示例

该示例添加了用于记录 webRequest.StreamFilter.error 值的 onerror 监听器。

js
function listener(details) {
  // 该示例并不太有用,因为扩展应该会使用“details.requestId”作为参数传递
  let filter = browser.webRequest.filterResponseData("12345");

  filter.onerror = (event) => {
    console.log(`错误:${filter.error}`);
  };
}

browser.webRequest.onBeforeRequest.addListener(
  listener,
  { urls: ["<all_urls>"], types: ["main_frame"] },
  ["blocking"],
);

该示例则为不使用 "blocking" 的情况。

js
function listener(details) {
  let filter = browser.webRequest.filterResponseData(details.requestId);

  filter.onerror = (event) => {
    console.log(`错误:${filter.error}`); // 错误:Invalid request ID
  };
}

browser.webRequest.onBeforeRequest.addListener(listener, {
  urls: ["<all_urls>"],
  types: ["main_frame"],
});