大网数据广告活动
Web 标准与前端开发

SpeechSynthesisErrorEvent: SpeechSynthesisErrorEvent() constructor

· 52CE 我爱测

The **`SpeechSynthesisErrorEvent()`** constructor creates a new SpeechSynthesisErrorEvent object.

Web Speech API

The SpeechSynthesisErrorEvent() constructor creates a new SpeechSynthesisErrorEvent object.

[!NOTE] A web developer doesn't typically need to call this constructor, as the browser creates these objects itself when firing events.

Syntax

new SpeechSynthesisErrorEvent(type, options)

Parameters

  • type
    • : A string with the name of the event. It is case-sensitive and browsers set it to error.
  • options
    • : An object that, in addition to the properties defined in SpeechSynthesisEvent/SpeechSynthesisEvent, has the following properties:
      • error
        • : A string containing the error reason. Possible values are:
          • canceled
            • : A SpeechSynthesis.cancel method call caused the SpeechSynthesisUtterance to be removed from the queue before speech started.
          • interrupted
            • : A SpeechSynthesis.cancel method call caused the SpeechSynthesisUtterance to be interrupted after speech had started but before it completed.
          • audio-busy
            • : The operation couldn't be completed at this time because the user-agent couldn't access the audio output device (for example, the user may need to correct this by closing another application).
          • audio-hardware
            • : The operation couldn't be completed at this time because the user-agent couldn't identify an audio output device (for example, the user may need to connect a speaker or configure system settings.)
          • network
            • : The operation couldn't be completed at this time because some required network communication failed.
          • synthesis-unavailable
            • : The operation couldn't be completed at this time because no synthesis engine was available (for example, the user may need to install or configure a synthesis engine).
          • synthesis-failed
            • : The operation failed because the synthesis engine raised an error.
          • language-unavailable
            • : No appropriate voice was available for the language set in SpeechSynthesisUtterance.lang. You can use the window.speechSynthesis.getVoices() method to determine which voices and languages are supported in the user's browser.
          • voice-unavailable
            • : The voice set in SpeechSynthesisUtterance.voice was not available.
          • text-too-long
            • : The contents of the SpeechSynthesisUtterance.text attribute was too long to synthesize.
          • invalid-argument
            • : The content of the SpeechSynthesisUtterance.rate, SpeechSynthesisUtterance.pitch or SpeechSynthesisUtterance.volume property was not valid.
          • not-allowed
            • : The operation's start was not allowed.

Return value

A new SpeechSynthesisErrorEvent object.

Specifications

Browser compatibility

See also

  • SpeechSynthesisEvent

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。