Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori