Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

CustomEvent — des événements avec des données personnalisées

CustomEvent étend Event avec detail, ce qui permet de transmettre des données définies par l’application aux écouteurs de l’événement.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })

CustomEvent est une interface de l’API Web issue du DOM Standard, et non d’ECMAScript. Son constructeur accepte un nom d’événement et des paramètres facultatifs. L’option detail permet de transmettre toute valeur JavaScript sauf undefined. Si vous omettez cette option ou lui passez explicitement undefined, Web IDL utilise la valeur par défaut null. Les objets ne sont pas copiés.

Créer un événement ne le déclenche pas : appelez dispatchEvent() sur un EventTarget. Enregistrez les écouteurs avec addEventListener(). Le déclenchement est synchrone. Les options bubbles, cancelable et composed valent false par défaut. Vérifiez la disponibilité de l’API dans le navigateur cible ; la version de Node du dépôt ne permet pas de l’établir.

Exemples

{
  const target = new EventTarget();
  target.addEventListener("score", (event) => {
    console.log(`score=${event.detail}`);
  });
  target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
  console.log("done");
}

Résultat

score=7
done

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources