CKTIS / JavaScript
CustomEvent.detail — údaje vlastnej udalosti
CustomEvent.detail sprístupňuje údaje odovzdané pri vytvorení udalosti. Predvolená hodnota je null; objekty sa odovzdávajú bez klonovania.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail je vlastnosť inštancie CustomEvent, ktorá obsahuje údaje nastavené pomocou voľby detail konštruktora. Ak voľbu detail vynecháte alebo ju výslovne nastavíte na undefined, Web IDL použije predvolenú hodnotu null, takže platí event.detail === null.
Vlastnosť je iba na čítanie, uložený objekt však nezamyká. Objekt sa neklonuje: zmena event.detail.count upraví ten istý objekt, ktorý bol odovzdaný konštruktoru.
Poslucháč číta údaje prostredníctvom event.detail. Príklad ukazuje zdieľanú referenciu a predvolenú hodnotu null. Ide o rozhranie DOM, nie o funkciu jazyka ECMAScript; prítomnosť Node 24 v repozitári nepotvrdzuje podporu v prehliadačoch.
Príklady
const target = new EventTarget();
const payload = { count: 1 };
target.addEventListener("count-change", (event) => {
console.log(event.detail === payload);
event.detail.count += 1;
});
target.dispatchEvent(new CustomEvent("count-change", { detail: payload }));
console.log(payload.count);
console.log(new CustomEvent("empty").detail);Výsledok
true 2 null
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.