SpeechSynthesisEvent: SpeechSynthesisEvent() 构造函数

SpeechSynthesisEvent() 构造函数创建一个新的 SpeechSynthesisEvent 对象。

注意:Web 开发人员通常不需要调用此构造函数,因为浏览器在触发事件时会自行创建这些对象。

语法

js
new SpeechSynthesisEvent(type, options)

参数

type

包含事件名称的字符串。它区分大小写,浏览器将其设置为 startenderrorpauseresumemarkboundary

options

一个对象,除了 Event() 中定义的属性外,还具有以下属性

utterance

一个 SpeechSynthesisUtterance 对象,它是触发该事件的语音请求。

charIndex 可选

触发事件时正在朗读的 SpeechSynthesisUtterance.text 中字符的索引位置。其默认值为 0

charLength 可选

charIndex 位置的字符之后,剩余需要朗读的字符数。其默认值为 0

elapsedTime 可选

触发事件时,SpeechSynthesisUtterance.text 开始朗读后的经过时间(以秒为单位)。其默认值为 0

name 可选

与某些类型的事件关联的名称:在 mark 事件的情况下,到达的 SSML 标记的名称;在 boundary 事件的情况下,到达的边界类型。默认为空字符串 ("")。

返回值

一个新的 SpeechSynthesisEvent 对象。

规范

规范
Web 语音 API
# dom-speechsynthesisevent-speechsynthesisevent

浏览器兼容性

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

另请参阅