SpeechSynthesisUtterance: mark event
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.
Themark event of theWeb Speech APISpeechSynthesisUtterance object is fired when the spoken utterance reaches a named SSML "mark" tag.
In this article
Syntax
Use the event name in methods likeaddEventListener(), or set an event handler property.
addEventListener("mark", (event) => { })onmark = (event) => { }Event type
ASpeechSynthesisEvent. Inherits fromEvent.
Event properties
In addition to the properties listed below, properties from the parent interface,Event, are available.
charIndexRead onlyReturns the index position of the character in the
SpeechSynthesisUtterance.textthat was being spoken when the event was triggered.elapsedTimeRead onlyReturns the elapsed time in seconds after the
SpeechSynthesisUtterance.textstarted being spoken that the event was triggered at.nameRead onlyReturns the name associated with certain types of events occurring as the
SpeechSynthesisUtterance.textis being spoken: the name of theSSML marker reached in the case of amarkevent, or the type of boundary reached in the case of aboundaryevent.utteranceRead onlyReturns the
SpeechSynthesisUtteranceinstance that the event was triggered on.
Examples
You can use themark event in anaddEventListener method:
utterThis.addEventListener("mark", (event) => { console.log(`A mark was reached: ${event.name}`);});Or use theonmark event handler property:
utterThis.onmark = (event) => { console.log(`A mark was reached: ${event.name}`);};Specifications
| Specification |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-mark> |
| Web Speech API> # dom-speechsynthesisutterance-onmark> |