CKTIS / JavaScript
EventTarget.addEventListener — registrácia poslucháčov udalostí
EventTarget.addEventListener registruje funkciu callback pre udalosť. Možnosti capture, once a passive určujú jej vyvolanie a to, či môže poslucháč udalosť zrušiť.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registruje callback pre typ udalosti type. Tretím argumentom je objekt možností alebo logická hodnota predstavujúca capture. Toto API patrí do štandardu DOM, nie do samotného ECMAScriptu.
capture: true vyberá u predkov fázu zachytávania namiesto bubblingu; obe nastavenia umožňujú vyvolanie priamo na cieli. capture aj once majú predvolenú hodnotu false. Pri nastavení once: true sa registrácia odstráni ešte pred zavolaním callback. Ak callback počas svojho vykonávania vyvolá udalosť, toto vnorené vyvolanie nemôže znova zavolať callback prostredníctvom tej istej registrácie. passive: true bráni zrušeniu pomocou preventDefault(), ale nezastaví šírenie. Ak chceš zrušiť zrušiteľnú udalosť, nastav výslovne passive: false: vynechanie možnosti neznamená vždy false.
Duplicitné registrácie sa rozpoznávajú podľa type, identity callback a capture; opätovná registrácia možnosti neaktualizuje. removeEventListener vyžaduje tie isté tri hodnoty. Príklad používa samostatný cieľ, takže neukazuje šírenie medzi prvkami.
Príklady
const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
calls++;
event.preventDefault();
}, { capture: false, once: true, passive: false });
const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);Výsledok
1 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tej presnej verzie.