SpeechSynthesisUtterance: boundary イベント
boundary
は ウェブ音声 API のイベントで、発話が胡屋分の境界に達したときに発生します。
構文
このイベント名を addEventListener()
などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
js
addEventListener("boundary", (event) => {});
onboundary = (event) => {};
イベント型
SpeechSynthesisEvent
です。 Event
を継承しています。
イベントプロパティ
以下に挙げたプロパティに加え、親インターフェイスである Event
のプロパティが利用可能です。
charIndex
読取専用-
イベントが発生したときに発話されていた
SpeechSynthesisUtterance.text
内の文字のインデックス位置を返します。 elapsedTime
読取専用-
イベントが発生した時点の
SpeechSynthesisUtterance.text
が話し始めてからの経過時間(秒)を返します。 name
読取専用-
SpeechSynthesisUtterance.text
が発話される際に発生する特定の種類のイベントに関連する名前を返します。mark
イベントの場合は到達した SSML マーカーの名前、boundary
イベントの場合は到達した境界の種類です。 utterance
読取専用-
イベントが発生した
SpeechSynthesisUtterance
インスタンスを返します。
例
boundary
イベントを addEventListener
メソッドで使用することができます。
js
utterThis.addEventListener("boundary", (event) => {
console.log(
`${event.name} boundary reached after ${event.elapsedTime} seconds.`,
);
});
または onboundary
イベントハンドラープロパティで使用することができます。
js
utterThis.onboundary = (event) => {
console.log(
`${event.name} boundary reached after ${event.elapsedTime} seconds.`,
);
};
仕様書
Specification |
---|
Web Speech API # eventdef-speechsynthesisutterance-boundary |
Web Speech API # dom-speechsynthesisutterance-onboundary |
ブラウザーの互換性
BCD tables only load in the browser