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.
- : A string with the name of the event.
It is case-sensitive and browsers set it to
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.
- : No appropriate voice was available for the language set in SpeechSynthesisUtterance.lang. You can use the
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.
- : A string containing the error reason. Possible values are:
- : An object that, in addition to the properties defined in SpeechSynthesisEvent/SpeechSynthesisEvent, has the following properties:
Return value
A new SpeechSynthesisErrorEvent object.
Specifications
Browser compatibility
See also
- SpeechSynthesisEvent
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
