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 貢獻者修改。