addEventListener 方法的第三个参数可以是一个布尔值、一个对象,或者是省略不填。
布尔值
addEventListener 方法的第三个参数是一个布尔值,表示事件是在捕获阶段还是在冒泡阶段处理。
如果这个参数为 true,那么事件是在捕获阶段处理的;如果这个参数为 false(或者省略不填),那么事件是在冒泡阶段处理的。
在捕获阶段和冒泡阶段中,事件处理程序可以通过 event 对象的 phase 属性来识别当前所处的阶段。如果 phase 属性的值为 1,则代表捕获阶段;如果 phase 属性的值为 2,则代表目标阶段;如果 phase 属性的值为 3,则代表冒泡阶段。
对象
这个对象可以包含三个属性:
- capture:布尔值,表示监听器是否在捕获阶段执行。
- once:布尔值,表示监听器是否仅执行一次。
- passive:布尔值,表示监听器不会调用 preventDefault()。
例如,以下代码使用了对象参数来注册一个仅执行一次的事件监听器:
element.addEventListener('click', myClickHandler, { once: true });
注意,当对象参数和布尔值参数同时使用时,对象参数会优先生效。