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

CKTIS / JavaScript

CustomEvent — události s vlastními daty

CustomEvent rozšiřuje Event o detail, takže se k posluchačům události mohou dostat data definovaná aplikací.

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

new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })

CustomEvent je rozhraní Web API ze standardu DOM Standard, nikoli součást ECMAScriptu. Jeho konstruktor přijímá název události a volitelná nastavení. Pomocí volby detail lze předat libovolnou hodnotu JavaScriptu kromě undefined. Pokud tuto volbu vynecháte nebo explicitně předáte undefined, podle pravidel Web IDL se použije výchozí hodnota null. Objekty se nekopírují.

Vytvořením události se událost neodešle: zavolejte dispatchEvent() na objektu EventTarget. Posluchače registrujte pomocí addEventListener(). Odeslání je synchronní. Možnosti bubbles, cancelable a composed mají ve výchozím nastavení hodnotu false. Dostupnost API ověřte v cílovém prohlížeči; verze Node v repozitáři ji nepotvrzuje.

Příklady

{
  const target = new EventTarget();
  target.addEventListener("score", (event) => {
    console.log(`score=${event.detail}`);
  });
  target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
  console.log("done");
}

Výsledek

score=7
done

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