CKTIS / JavaScript
CustomEvent — gebeurtenissen met aangepaste gegevens
CustomEvent breidt Event uit met detail, zodat toepassingsspecifieke gegevens de listeners van een gebeurtenis kunnen bereiken.
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
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent is een Web API-interface uit de DOM Standard, niet uit ECMAScript. De constructor accepteert een gebeurtenisnaam en optionele instellingen. Met de optie detail kun je elke JavaScript-waarde behalve undefined doorgeven. Als je deze optie weglaat of expliciet undefined doorgeeft, gebruikt Web IDL de standaardwaarde null. Objecten worden niet gekopieerd.
Een gebeurtenis aanmaken verstuurt die niet: roep dispatchEvent() aan op een EventTarget. Registreer listeners met addEventListener(). Het versturen gebeurt synchroon. De opties bubbles, cancelable en composed zijn standaard false. Controleer of de API beschikbaar is in de doelbrowser; de Node-versie van de repository bevestigt dit niet.
Voorbeelden
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Resultaat
score=7 done
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.