SourceBuffer: error 事件

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

注意:此功能在 专用 Web Workers 中可用。

SourceBuffer 接口的 error 事件会在 appendBuffer() 操作处理过程中发生错误时触发。例如,当要追加的数据格式不正确、SourceBuffer 处于无效状态,或者用户代理无法处理数据时,都可能发生这种情况。此时,updating 属性会从 true 变为 false。此事件在 updateend 事件之前触发。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

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

onerror = (event) => { }

事件类型

一个通用的 Event

示例

处理 appendBuffer() 过程中的错误

此示例演示了如何处理 appendBuffer() 操作过程中发生的错误。

js
const sourceBuffer = source.addSourceBuffer(mimeCodec);
sourceBuffer.addEventListener("error", () => {
  downloadStatus.textContent = "Error occurred during decoding";
});
sourceBuffer.addEventListener("update", () => {
  downloadStatus.textContent = "Done";
});
sourceBuffer.addEventListener("updateend", () => {
  source.endOfStream();
});
downloadStatus.textContent = "Downloading...";
fetch(assetURL)
  .then((response) => response.arrayBuffer())
  .then((data) => {
    downloadStatus.textContent = "Decoding...";
    sourceBuffer.appendBuffer(data);
  });

规范

规范
Media Source Extensions™
# dfn-error
Media Source Extensions™
# dom-sourcebuffer-onerror

浏览器兼容性

另见