SpeechSynthesisUtterance:start 事件

Baseline 已广泛支持

此功能已成熟,并可在多种设备和浏览器版本上使用。自 2018 年 9 月以来,它已在各种浏览器中推出。

Web Speech API 的 SpeechSynthesisUtterance 对象的 start 事件在语音开始朗读时触发。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("start", (event) => { })

onstart = (event) => { }

事件类型

一个 SpeechSynthesisEvent。继承自 Event

Event SpeechSynthesisEvent

事件属性

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

charIndex 只读

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

elapsedTime 只读

返回事件触发时,在 SpeechSynthesisUtterance.text 开始朗读后经过的秒数。

name 只读

返回与 SpeechSynthesisUtterance.text 正在朗读时发生的某些类型事件相关的名称:对于 mark 事件,是遇到的 SSML 标记的名称;对于 boundary 事件,是遇到的边界的类型。

utterance 只读

返回触发事件的 SpeechSynthesisUtterance 实例。

示例

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

js
utterThis.addEventListener("start", (event) => {
  console.log(`We have started uttering this speech: ${event.utterance.text}`);
});

或者使用 onstart 事件处理程序属性。

js
utterThis.onstart = (event) => {
  console.log(`We have started uttering this speech: ${event.utterance.text}`);
};

规范

规范
Web Speech API
# eventdef-speechsynthesisutterance-start
Web Speech API
# dom-speechsynthesisutterance-onstart

浏览器兼容性

另见