CKTIS / JavaScript
CustomEvent.detail — data vlastní události
CustomEvent.detail zpřístupňuje data předaná při vytvoření události. Výchozí hodnota je null; objekty se předávají bez klonování.
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
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail je vlastnost instance CustomEvent, která obsahuje data nastavená pomocí volby detail konstruktoru. Pokud volbu detail vynecháte nebo ji výslovně nastavíte na undefined, Web IDL použije výchozí hodnotu null, takže platí event.detail === null.
Vlastnost je pouze pro čtení, uložený objekt však nezamyká. Objekt se neklonuje: změna event.detail.count upraví tentýž objekt, který byl předán konstruktoru.
Posluchač čte data prostřednictvím event.detail. Příklad ukazuje sdílenou referenci a výchozí hodnotu null. Jde o rozhraní DOM, nikoli o funkci jazyka ECMAScript; přítomnost Node 24 v repozitáři nepotvrzuje podporu v prohlížečích.
Pří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ýsledek
true 2 null
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.