Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

EventTarget — příjem a vyvolávání událostí

EventTarget je rozhraní Web API pro registraci posluchačů a vyvolávání událostí. Samostatnou instanci lze vytvořit bez prvku DOM.

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

const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);

EventTarget je rozhraní Web API, nikoli součást standardu ECMAScript. new EventTarget() vytvoří samostatný cíl událostí bez rodiče ve stromu propagace.

addEventListener() zaregistruje posluchače. removeEventListener() vyžaduje stejný typ události, stejnou referenci na callback a odpovídající hodnotu capture. S volbou once: true se registrace posluchače automaticky odstraní ještě před zavoláním jeho callbacku. Pokud callback vyvolá novou událost stejného typu na stejném cíli, odstraněná registrace už nepovede k dalšímu zavolání callbacku.

dispatchEvent() vyvolává posluchače synchronně. Vrací false, pokud je nastaven příznak zrušení události; jinak vrací true. U zrušitelné události lze tento příznak nastavit voláním preventDefault() nebo přiřazením event.returnValue = false, které je zachováno kvůli kompatibilitě. Výsledek neříká, zda posluchač existuje. Příklad vyžaduje prostředí, které poskytuje EventTarget a Event, ale prohlížeč není nutný. V Node.js 24 funguje beze změn, což nedokládá kompatibilitu s prohlížeči.

Příklady

const target = new EventTarget();
const log = [];

function onPing(event) {
  log.push(event.type);
  event.preventDefault();
}

target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));

console.log(log.join(','));
console.log(first);
console.log(second);

Výsledek

ping
false
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.

Zdroje