KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.detail

CustomEvent.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.

Bronnen