Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers.
Les événements déclenchés manuellement avec dispatchEvent() suivent les mêmes règles de gestion que les événements natifs, y compris la phase de capture et, éventuellement, de propagation.
La méthode dispatchEvent() de l'interface EventTarget envoie un objet Event à la cible, invoquant (de façon synchrone) les écouteurs d'événements concernés dans l'ordre approprié. Les règles normales de gestion des événements (y compris la phase de capture et, éventuellement, de propagation) s'appliquent aussi aux événements déclenchés manuellement avec dispatchEvent().
Appeler dispatchEvent() est la dernière étape pour déclencher un événement. L'événement doit déjà avoir été créé et initialisé à l'aide d'un constructeur Event().
Note : Lors de l'appel à cette méthode, la propriété Event.target est initialisée à la valeur de l'EventTarget courant.
Contrairement aux événements « natifs », qui sont déclenchés par le navigateur et invoquent les gestionnaires d'événements de façon asynchrone via la boucle d'événements, dispatchEvent() invoque les gestionnaires d'événements de façon synchrone. Tous les gestionnaires concernés sont appelés et terminent leur exécution avant que dispatchEvent() ne retourne.
L'objet Event à déclencher. Sa propriété Event.target sera définie sur la valeur de l'EventTarget courant.
Retourne false si event est annulable et qu'au moins un des gestionnaires d'événements ayant reçu event ayant appelé Event.preventDefault(). Sinon, retourne true.
Levée si le type de l'événement n'a pas été spécifié lors de l'initialisation de l'événement.
Attention : Les exceptions levées par les gestionnaires d'événements sont signalées comme des exceptions non interceptées. Les gestionnaires d'événements s'exécutent sur une pile d'appels imbriquée : ils bloquent l'appelant jusqu'à leur achèvement, mais les exceptions ne sont pas propagées à l'appelant.
Voir Créer et déclencher des événements.
| DOM # ref-for-dom-eventtarget-dispatchevent③ |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 28 sept. 2025 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.