Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri