CustomEvent

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

BCD tables only load in the browser

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 qu'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