CKTIS / JavaScript
CustomEvent — događaji s prilagođenim podacima
CustomEvent proširuje Event svojstvom detail, pa podaci koje definira aplikacija mogu stići do slušatelja događaja.
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
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent sučelje je Web API-ja iz standarda DOM Standard, a ne dio ECMAScripta. Njegov konstruktor prima naziv događaja i neobavezne postavke. Opcijom detail možete prenijeti bilo koju vrijednost JavaScripta osim undefined. Ako izostavite tu opciju ili izričito proslijedite undefined, prema pravilima Web IDL-a upotrebljava se zadana vrijednost null. Objekti se ne kopiraju.
Stvaranje događaja ne šalje ga: pozovite dispatchEvent() na objektu EventTarget. Slušatelje registrirajte pomoću addEventListener(). Slanje je sinkrono. Opcije bubbles, cancelable i composed zadano imaju vrijednost false. Dostupnost API-ja provjerite u ciljnom pregledniku; verzija Nodea u repozitoriju to ne potvrđuje.
Primjeri
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Rezultat
score=7 done
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.