此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Event() 构造函数

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

备注: 此特性在 Web Worker 中可用。

Event() 构造函数用于创建一个新的 Event 对象。以这种方式创建的事件称为合成事件,区别于由浏览器触发的事件,可以由脚本派发

语法

js
new Event(type)
new Event(type, options)

type

一个字符串,表示事件的名称。

options 可选

一个对象,包含以下属性:

bubbles 可选

一个布尔值,表示该事件是否冒泡。默认值为 false

cancelable 可选

一个布尔值,表示该事件是否可以被取消。默认值为 false

composed 可选

一个布尔值,表示该事件是否会在影子 DOM 根节点之外触发监听器(详见 Event.composed)。默认值为 false

返回值

一个新的 Event 对象。

示例

js
// 创建一个支持冒泡且不能被取消的 look 事件

const evt = new Event("look", { bubbles: true, cancelable: false });
document.dispatchEvent(evt);

// 事件可以在任何元素上派发,不仅仅是 document
myDiv.dispatchEvent(evt);

规范

规范
DOM
# ref-for-dom-event-event

浏览器兼容性

参见