事件:initEvent() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

注意:此功能在 Web Workers 中可用。

Event.initEvent() 方法用于初始化使用 Document.createEvent() 创建的 event 的值。

以这种方式初始化的事件必须是使用 Document.createEvent() 方法创建的。在通过 EventTarget.dispatchEvent() 分派事件之前,必须调用此方法来设置事件。一旦分派,它将不再起任何作用。

注意: 请勿再使用此方法,因为它已弃用。 请改用特定的事件构造函数,例如 Event()。有关如何使用这些构造函数的更多信息,请参阅 创建和分派事件 部分。

语法

js
initEvent(type, bubbles, cancelable)

参数

type

定义事件类型的字符串。

bubbles

一个布尔值,决定事件是否应该冒泡通过事件链。设置后,只读属性 Event.bubbles 将给出其值。

cancelable

一个布尔值,定义事件是否可以被取消。设置后,只读属性 Event.cancelable 将给出其值。

返回值

无。

示例

js
// Create the event.
const event = document.createEvent("Event");

// Create a click event that bubbles up and
// cannot be canceled
event.initEvent("click", true, false);

// Listen for the event.
elem.addEventListener("click", (e) => {
  // e.target matches elem
});

elem.dispatchEvent(event);

规范

规范
DOM
# dom-event-initevent

浏览器兼容性

另见

  • 替代此已弃用方法的构造函数:Event()。要创建比 Event 更具体的事件接口,请使用为所需事件接口定义的构造函数。