SpeechSynthesisUtterance：错误事件

基线 广泛可用

此功能已得到很好的建立，并且可以在许多设备和浏览器版本中使用。它从以下浏览器中可用 2018 年 9 月.

error 事件是 Web 语音 API SpeechSynthesisUtterance 对象的一个事件，当发生阻止话语成功说出语的错误时触发。

语法

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

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

onerror = (event) => {};

事件类型

一个 SpeechSynthesisErrorEvent。继承自 SpeechSynthesisEvent 和 Event。

Event SpeechSynthesisEvent SpeechSynthesisErrorEvent

事件属性

除了下面列出的属性外，父接口 Event 的属性也可使用。

charIndex 只读

返回在触发事件时正在发声的 SpeechSynthesisUtterance.text 中字符的索引位置。

elapsedTime 只读

返回在触发事件时 SpeechSynthesisUtterance.text 开始发声后的经过时间（以秒为单位）。

error 只读

返回一个错误代码，指示语音合成尝试中出现的问题。

name 只读

返回与在 SpeechSynthesisUtterance.text 发声时发生的某些类型的事件相关的名称：在 mark 事件的情况下，到达的 SSML 标记的名称；在 boundary 事件的情况下，到达的边界类型。

utterance 只读

返回触发事件的 SpeechSynthesisUtterance 实例。

示例

您可以在 addEventListener 方法中使用 error 事件

js
utterThis.addEventListener("error", (event) => {
  console.log(
    `An error has occurred with the speech synthesis: ${event.error}`,
  );
});

或使用 onerror 事件处理程序属性

js
utterThis.onerror = (event) => {
  console.log(
    `An error has occurred with the speech synthesis: ${event.error}`,
  );
};

规范

规范
Web 语音 API
# eventdef-speechsynthesisutterance-error
Web 语音 API
# dom-speechsynthesisutterance-onerror

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅