CKTIS / JavaScript
CustomEvent — dogodki z lastnimi podatki
CustomEvent razširi Event z detail, zato lahko do poslušalcev dogodka posreduje podatke, ki jih določi aplikacija.
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
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent je vmesnik Web API iz standarda DOM Standard, ne pa del ECMAScript. Njegov konstruktor sprejme ime dogodka in neobvezne nastavitve. Z možnostjo detail lahko posredujete katero koli vrednost JavaScripta razen undefined. Če to možnost izpustite ali izrecno podate undefined, se po pravilih Web IDL uporabi privzeta vrednost null. Objekti se ne kopirajo.
Ustvarjanje dogodka ga ne pošlje: na objektu EventTarget pokličite dispatchEvent(). Poslušalce registrirajte z addEventListener(). Pošiljanje je sinhrono. Možnosti bubbles, cancelable in composed so privzeto nastavljene na false. Razpoložljivost API-ja preverite v ciljnem brskalniku; različica Node v repozitoriju tega ne potrjuje.
Primeri
{
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.