CKTIS / JavaScript
CustomEvent.detail — podatki dogodka po meri
CustomEvent.detail razkrije podatke, podane ob ustvarjanju dogodka. Privzeta vrednost je null; objekti se posredujejo brez kloniranja.
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
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail je lastnost primerka CustomEvent, ki vsebuje podatke, nastavljene z možnostjo detail konstruktorja. Če možnost detail izpustite ali jo izrecno nastavite na undefined, Web IDL uporabi privzeto vrednost null, zato velja event.detail === null.
Lastnost je samo za branje, vendar shranjenega objekta ne zamrzne. Objekt se ne klonira: sprememba event.detail.count spremeni isti objekt, ki je bil posredovan konstruktorju.
Poslušalnik prebere podatke prek event.detail. Primer prikazuje skupno referenco in privzeto vrednost null. To je vmesnik DOM, ne funkcija jezika ECMAScript; prisotnost Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.
Primeri
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);Rezultat
true 2 null
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.