CKTIS / JavaScript
CustomEvent.detail — gegevens van aangepaste gebeurtenissen
CustomEvent.detail geeft gegevens weer die bij het maken van een gebeurtenis zijn meegegeven. De standaardwaarde is null; objecten worden doorgegeven zonder te worden gekloond.
Versie: 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 is een instantie-eigenschap van CustomEvent die gegevens bevat die zijn ingesteld via de detail-optie van de constructor. Als detail wordt weggelaten of expliciet op undefined wordt gezet, gebruikt Web IDL de standaardwaarde null, zodat event.detail === null geldt.
De eigenschap is alleen-lezen, maar maakt het opgeslagen object niet onveranderlijk. Het object wordt niet gekloond: een wijziging van event.detail.count verandert hetzelfde object dat aan de constructor is doorgegeven.
Een listener leest de gegevens via event.detail. Het voorbeeld laat de gedeelde verwijzing en de standaardwaarde null zien. Dit is een DOM-interface, geen functie van de ECMAScript-taal; de aanwezigheid van Node 24 in een repository toont geen browserondersteuning aan.
Voorbeelden
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);Resultaat
true 2 null
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.