SpeechSynthesisUtterance: boundary event
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Theboundary event of theWeb Speech API is fired when the spoken utterance reaches a word or sentence boundary.
In this article
Syntax
Use the event name in methods likeaddEventListener(), or set an event handler property.
addEventListener("boundary", (event) => { })onboundary = (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 theboundary event in anaddEventListener method:
utterThis.addEventListener("boundary", (event) => { console.log( `${event.name} boundary reached after ${event.elapsedTime} seconds.`, );});Or use theonboundary event handler property:
utterThis.onboundary = (event) => { console.log( `${event.name} boundary reached after ${event.elapsedTime} seconds.`, );};Specifications
| Specification |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-boundary> |
| Web Speech API> # dom-speechsynthesisutterance-onboundary> |