Web Speech API
The SpeechSynthesisEvent() constructor creates a new SpeechSynthesisEvent 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 SpeechSynthesisEvent(type, options)
Parameters
type- : A string with the name of the event.
It is case-sensitive and browsers set it to
start,end,error,pause,resume,mark, orboundary.
- : 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 Event/Event, has the following properties:
utterance- : A SpeechSynthesisUtterance object, which is the speech request the event was triggered on.
charIndex- : The index position of the character in SpeechSynthesisUtterance.text that was being spoken when the event was triggered. Its default value is
0.
- : The index position of the character in SpeechSynthesisUtterance.text that was being spoken when the event was triggered. Its default value is
charLength- : The number of characters left to be spoken after the character at the SpeechSynthesisEvent.charIndex position. Its default value is
0.
- : The number of characters left to be spoken after the character at the SpeechSynthesisEvent.charIndex position. Its default value is
elapsedTime- : The elapsed time in seconds, after the SpeechSynthesisUtterance.text started being spoken, at which the event was triggered. Its default value is
0.
- : The elapsed time in seconds, after the SpeechSynthesisUtterance.text started being spoken, at which the event was triggered. Its default value is
name- : The name associated with certain types of events: the name of the SSML marker reached in the case of a SpeechSynthesisUtterance.mark_event event, or the type of boundary reached in the case of a SpeechSynthesisUtterance.boundary_event event. It defaults to the empty string (
"").
- : The name associated with certain types of events: the name of the SSML marker reached in the case of a SpeechSynthesisUtterance.mark_event event, or the type of boundary reached in the case of a SpeechSynthesisUtterance.boundary_event event. It defaults to the empty string (
- : An object that, in addition to the properties defined in Event/Event, has the following properties:
Return value
A new SpeechSynthesisEvent object.
Specifications
Browser compatibility
See also
- SpeechSynthesisErrorEvent
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
