CKTIS / JavaScript
EventTarget.addEventListener — registracija poslušalcev dogodkov
EventTarget.addEventListener registrira funkcijo callback za dogodek. Možnosti capture, once in passive določajo njen priklic in to, ali lahko poslušalec dogodek prekliče.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registrira callback za vrsto dogodka type. Tretji argument je objekt možnosti ali logična vrednost, ki predstavlja capture. Ta API spada v standard DOM, ne v sam ECMAScript.
capture: true pri prednikih izbere fazo zajemanja namesto bubblinga; obe nastavitvi omogočata priklic na samem cilju. Privzeti vrednosti za capture in once sta false. Pri once: true se registracija odstrani, preden se pokliče callback. Če callback med izvajanjem sproži dogodek, ta ugnezdena sprožitev ne more znova poklicati callback prek iste registracije. passive: true prepreči preklic z preventDefault(), vendar ne ustavi širjenja. Če želiš preklicati dogodek, ki ga je mogoče preklicati, izrecno nastavi passive: false: izpuščena možnost ne pomeni vedno false.
Podvojene registracije se prepoznajo po type, identiteti callback in capture; ponovna registracija možnosti ne posodobi. removeEventListener zahteva iste tri vrednosti. Primer uporablja samostojen cilj, zato ne prikazuje širjenja med elementi.
Primeri
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);Rezultat
1 true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.