事件：initEvent() 方法

已弃用： 不再推荐使用此功能。尽管某些浏览器可能仍然支持它，但它可能已从相关的 Web 标准中删除，可能正在被弃用，或者可能仅出于兼容性目的而保留。避免使用它，并尽可能更新现有代码；请参阅此页面底部的兼容性表，以指导您的决策。请注意，此功能可能随时停止工作。

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

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

以这种方式初始化的事件必须使用 Document.createEvent() 方法创建。必须调用此方法来设置事件，然后再使用 EventTarget.dispatchEvent() 分派它。一旦分派，它就不会再做任何事情了。

注意：不要再使用此方法，因为它已弃用。 请改用特定的事件构造函数，例如 Event()。关于 创建和触发事件 的页面提供了有关如何使用这些方法的更多信息。

语法

js
event.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
  },
  false,
);

elem.dispatchEvent(event);

规范

规范
DOM 标准
# ref-for-dom-event-initevent①

浏览器兼容性

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

另请参阅

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