geteventlisteners
v1.1.0
Published
getEventListeners() : Returns an object containing all the event listeners of a DOM Node.
Downloads
2,344
Maintainers
Readme
Element.prototype.getEventListeners()
Returns the event listeners registered on the specified object. The return value is an object that contains an array for each registered event type (click or keydown, for example). The members of each array are objects that describe the listener registered for each type.
A simple usage example :
let myEl = document.getElementById('someElementId');
// add some event listeners to the Element
myEl.addEventListener('click', e=> console.log('click!') );
myEl.addEventListener('click', e=> console.log('click 2!') );
myEl.addEventListener('mouseover', e=> console.log('mouse over!') );
// retrieve the listeners
console.log( myEl.getEventListeners() );
/*
{
click : [
{ listener: ƒ, useCapture: false, type:"click"},
{ listener: ƒ, useCapture: false, type:"click"}
],
mouseover : [
{ listener: ƒ, useCapture: false, type:"mouseover"}
]
}
*/
Retrieve only the click-event listeners :
console.log( myEl.getEventListeners('click') );
/*
[
{ listener: ƒ, useCapture: false, type:"click"},
{ listener: ƒ, useCapture: false, type:"click"}
]
*/
Package distribution :
You can include this library using the CDN ...
<script src='https://cdn.jsdelivr.net/gh/colxi/getEventListeners/src/getEventListeners.min.js'></script>
Package can also be installed via:
$ npm install geteventlisteners --save
and is also available in Github :
https://github.com/colxi/getEventListeners
Limitations
To be able to track the event listeners assignements, this module overwrites Element.prototype.addEventListener
and Element.prototype.removeEventListener
, with custom functions that mantain an updated list of listeners.
Any event listener declared before this module is imported will be missed.
In order to be able to track all the listeners, this module must be imported before any event listener is declared.
Only event listeners declared using Element.addEventListener()
, are going to be tracked. For example, the following event listeners declarations, will not be tracked :
<div onclick="myFunction()"></div>
and...
myElement.onclick= function(){ /*your code*/ }