Les interfaces CustomEvent DOM sont des évènements initialisés par une application pour n'importe quel usage.

Note : Cette fonctionnalité est disponible via les Web Workers.

Constructeur

CustomEvent()
Crée un CustomEvent.

Propriétés

CustomEvent.detail Lecture seule
Toute donnée transmise lors de l'initialisation de l'événement.

Cette interface hérite des propriétés de son parent Event:

Méthodes

CustomEvent.initCustomEvent()
Initialise un objet CustomEvent. Si l'événement a déjà été distribué, cette méthode ne fait rien.

Cette interface hérite les méthodes de son parent Event:

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'CustomEvent' dans cette spécification.
Standard évolutif Définition initial

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 6IE Support complet 9Opera Support complet 11Safari Support complet 5.1WebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android ?
Available in workersChrome Support complet OuiEdge Support complet OuiFirefox Support complet 48IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 48Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android ?
CustomEvent() constructorChrome Support complet 15Edge Support complet OuiFirefox Support complet 11IE Aucun support NonOpera Support complet 11.6Safari Aucun support Non
Notes
Aucun support Non
Notes
Notes Available on Nightly build (535.2)
WebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Aucun support Non
Notes
Aucun support Non
Notes
Notes Available on Nightly build (535.2)
Samsung Internet Android ?
detailChrome Support complet 11Edge ? Firefox Support complet 11IE Aucun support NonOpera Support complet 11.6Safari Aucun support Non
Notes
Aucun support Non
Notes
Notes Available on Nightly build (535.2)
WebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile ? Firefox Android Support complet 14Opera Android Support complet OuiSafari iOS Aucun support Non
Notes
Aucun support Non
Notes
Notes Available on Nightly build (535.2)
Samsung Internet Android ?
initCustomEvent
Obsolète
Chrome Support complet Oui
Support complet Oui
Support complet 59
Notes
Notes canBubble, cancelable, and detail are optional parameters defaulting to false, false, and null respectively.
Edge Support complet OuiFirefox Support complet 6IE Support complet 9Opera Support complet 11Safari Support complet 5.1WebView Android Support complet Oui
Support complet Oui
Support complet 59
Notes
Notes canBubble, cancelable, and detail are optional parameters defaulting to false, false, and null respectively.
Chrome Android Support complet Oui
Support complet Oui
Support complet 59
Notes
Notes canBubble, cancelable, and detail are optional parameters defaulting to false, false, and null respectively.
Edge Mobile Support complet OuiFirefox Android Support complet 6Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android ?

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Déclenchement à partir de code privilégié vers du code non-privilégié

Lors du déclenchement d'un CustomEvent depuis du code privilégié (une extension, par exemple) vers du code non-privilégié (une page web par exemple), vous devez prendre en considération la sécurité. Firefox et les autres applications Gecko empêchent q'un objet créé dans un contexte soit utilisé dans un autre, ce qui empêchera généralement les failles de sécurité, mais ces restrictions peuvent aussi empêcher votre code de s'executer comme prévu.

Lors de la création d'un objet CustomEvent, vous devez créer l'objet à partir de la même fenêtre que celle où vous déclencherez l'évenement.

// doc est une référence au contenu du document
function dispatchCustomEvent(doc) {
  var eventDetail = Components.utils.cloneInto({foo: 'bar'}, doc.defaultView);
  var myEvent = doc.defaultView.CustomEvent("mytype", eventDetail);
  doc.dispatchEvent(myEvent);
}

Notez qu'exposer une fonction permettra au script de l'exécuter avec les privilèges qu'accorde Chrome ce qui peut ouvrir une faille de sécurité.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : loella16, Hell_Carlito, J.DMB, jbenoit, Porkepix, Lionel_Peramo
Dernière mise à jour par : loella16,