CKTIS / JavaScript
EventTarget.addEventListener — registrace posluchačů událostí
EventTarget.addEventListener registruje funkci callback pro událost. Možnosti capture, once a passive určují její vyvolání a to, zda může posluchač událost zrušit.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registruje callback pro typ události type. Třetím argumentem je objekt možností nebo logická hodnota představující capture. Toto API patří do standardu DOM, nikoli do samotného ECMAScriptu.
capture: true vybírá u předků fázi zachytávání místo bubblingu; obě nastavení umožňují vyvolání přímo na cíli. capture i once mají výchozí hodnotu false. Při nastavení once: true se registrace odstraní ještě před zavoláním callback. Pokud callback během svého běhu vyvolá událost, toto vnořené vyvolání nemůže znovu zavolat callback prostřednictvím téže registrace. passive: true brání zrušení pomocí preventDefault(), ale nezastaví šíření. Chceš-li zrušit zrušitelnou událost, nastav výslovně passive: false: vynechání možnosti neznamená vždy false.
Duplicitní registrace se rozpoznávají podle type, identity callback a capture; opětovná registrace možnosti neaktualizuje. removeEventListener vyžaduje stejné tři hodnoty. Příklad používá samostatný cíl, takže neukazuje šíření mezi prvky.
Pří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ýsledek
1 true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.