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

CKTIS / JavaScript

EventTarget.dispatchEvent() : distribution synchrone d’événements

dispatchEvent(event) distribue un événement à une cible de façon synchrone. Sa valeur booléenne indique si l’événement a été annulé, et non s’il existe des écouteurs.

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

target.dispatchEvent(event)

target.dispatchEvent(event) distribue un objet Event à un EventTarget. Les écouteurs sont appelés de façon synchrone ; la méthode n’attend pas la fin des opérations asynchrones lancées par les écouteurs. L’événement a isTrusted === false.

Le résultat est false si l’événement est annulé, et true dans le cas contraire. preventDefault() n’annule l’événement que si cancelable: true et en dehors d’un écouteur passif. stopPropagation() ne signifie pas que l’événement est annulé.

Dans un arbre DOM, la capture et le bouillonnement facultatif (bubbles) s’appliquent. Un new EventTarget() autonome n’a pas de parent. Les exceptions des écouteurs sont signalées, mais ne remontent pas jusqu’à l’appelant. Redistribuer l’objet en cours de distribution provoque InvalidStateError.

L’exemple montre l’ordre synchrone et l’annulation. Le code de l’application peut utiliser le résultat pour ignorer l’enregistrement.

Exemples

const target = new EventTarget();
const log = [];

target.addEventListener("save", (event) => {
  log.push("listener");
  event.preventDefault();
});

log.push("before");
const accepted = target.dispatchEvent(
  new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));

Résultat

before | listener | after: false

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