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.