AudioWorkletNode:processorerror 事件

Baseline 已广泛支持

此特性已得到良好支持,可在多种设备和浏览器版本上使用。自 2021 年 4 月起,所有浏览器均已支持此特性。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

当节点背后的 AudioWorkletProcessor 在其构造函数、process 方法或任何用户定义的类方法中抛出异常时,会触发 processorerror 事件。

一旦抛出异常,处理器(以及节点)将在其整个生命周期内输出静默。

语法

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

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

onprocessorerror = (event) => { }

事件类型

一个通用的 Event

示例

要获知处理器何时抛出异常,您可以使用 addEventListener() 方法,为您的 AudioWorkletNode 实例添加一个处理程序,如下所示:

js
whiteNoiseNode.addEventListener("processorerror", (event) => {
  console.error("There was an error!");
});

或者,您也可以使用 onprocessorerror 事件处理程序属性来设置 processorerror 事件的处理程序。

js
whiteNoiseNode.onprocessorerror = (event) => {
  console.error("There was an error!");
};

规范

规范
Web Audio API
# dom-audioworkletnode-onprocessorerror

浏览器兼容性

另见