SpeechSynthesisUtterance：边界事件

boundary 事件是 Web 语音 API 的一个事件，当 spoken utterance 达到词语或句子边界时触发。

语法

在像 addEventListener() 这样的方法中使用事件名称，或者设置事件处理程序属性。

js
addEventListener("boundary", (event) => {});

onboundary = (event) => {};

事件类型

一个 SpeechSynthesisEvent。继承自 Event。

Event SpeechSynthesisEvent

事件属性

除了下面列出的属性外，父接口 Event 的属性也可以使用。

charIndex 只读

返回触发事件时正在发声的 SpeechSynthesisUtterance.text 中字符的索引位置。

elapsedTime 只读

返回触发事件时，SpeechSynthesisUtterance.text 开始发声后的经过时间（以秒为单位）。

name 只读

返回与 SpeechSynthesisUtterance.text 发声时发生的某些类型事件相关的名称：在 mark 事件中，返回所到达的 SSML 标记的名称；在 boundary 事件中，返回所到达的边界类型。

utterance 只读

返回触发该事件的 SpeechSynthesisUtterance 实例。

示例

您可以在 addEventListener 方法中使用 boundary 事件

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.`,
  );
};

规范

规范
Web 语音 API
# eventdef-speechsynthesisutterance-boundary
Web 语音 API
# dom-speechsynthesisutterance-onboundary

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载

另请参阅