SpeechSynthesisUtterance: error 事件

Baseline 已广泛支持

此功能已成熟，并可在多种设备和浏览器版本上使用。自 2018 年 9 月以来，它已在各种浏览器中推出。

Web Speech API 的 error 事件，在 SpeechSynthesisUtterance 对象上触发，表示在朗读过程中发生了错误，导致无法成功朗读。

语法

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

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

onerror = (event) => { }

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

charIndex 只读: 返回事件触发时，在 SpeechSynthesisUtterance.text 中正在朗读的字符的索引位置。
elapsedTime 只读: 返回事件触发时，在 SpeechSynthesisUtterance.text 开始朗读后经过的秒数。
error 只读: 返回一个错误代码，指示语音合成尝试中出现的问题。
name 只读: 返回与 SpeechSynthesisUtterance.text 正在朗读时发生的某些类型事件相关的名称：对于 mark 事件，是遇到的 SSML 标记的名称；对于 boundary 事件，是遇到的边界的类型。
utterance 只读: 返回触发事件的 SpeechSynthesisUtterance 实例。

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

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

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

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

规范
Web Speech API # eventdef-speechsynthesisutterance-error
Web Speech API # dom-speechsynthesisutterance-onerror

此页面最后修改于 2025年5月2日，由 MDN 贡献者修改。