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

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.

Viri