Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

EventTarget.addEventListener — registriranje slušatelja događaja

EventTarget.addEventListener registrira funkciju callback za događaj. Opcije capture, once i passive određuju njezino pozivanje i može li slušatelj otkazati događaj.

Verzija: 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 vrstu događaja type. Treći je argument objekt opcija ili Booleova vrijednost koja predstavlja capture. Ovaj API pripada standardu DOM, a ne samom ECMAScriptu.

capture: true odabire fazu hvatanja umjesto bubblinga na precima; obje postavke omogućuju pozivanje na samom cilju. Zadane su vrijednosti za capture i once false. Uz once: true registracija se uklanja prije poziva funkcije callback. Ako callback tijekom tog poziva pokrene događaj, to ugniježđeno pokretanje ne može ponovno pozvati callback putem iste registracije. passive: true onemogućuje otkazivanje putem preventDefault(), ali ne zaustavlja propagaciju. Za otkazivanje događaja koji se može otkazati izričito postavi passive: false: izostavljanje opcije ne znači uvijek false.

Duplikati se prepoznaju prema type, identitetu callback i vrijednosti capture; ponovna registracija ne ažurira opcije. removeEventListener zahtijeva iste tri vrijednosti. Primjer koristi samostalan cilj pa ne prikazuje propagaciju između elemenata.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori