SpeechSynthesisEvent: SpeechSynthesisEvent() 构造函数

Baseline 已广泛支持

此功能已成熟,并可在多种设备和浏览器版本上运行。自 2022 年 9 月起,所有浏览器都已支持此功能。

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 Speech API
# dom-speechsynthesisevent-speechsynthesisevent

浏览器兼容性

另见