SpeechSynthesisErrorEvent: SpeechSynthesisErrorEvent() constructor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨September 2022⁩.

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(), 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.