CustomEvent
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}{{AvailableInWorkers}}
The **CustomEvent** interface can be used to attach custom data to an event generated by an application.
As an alternative to CustomEvent, you can [subclass the Event interface](/en-US/docs/Web/API/Document_Object_Model/Events#adding_custom_data_–_subclassing_event) to add custom data and behavior.
توجه: If used to attempt to communicate between a web extension content script and a web page script, a non-string detail property throws with "Permission denied to access property" in Firefox. To avoid this issue clone the object. See Share objects with page scripts for more information.
{{InheritanceDiagram}}
Constructor
- {{domxref("CustomEvent.CustomEvent", "CustomEvent()")}}
- : Creates a new
CustomEvent.
Instance properties
_This interface inherits properties from its parent, {{domxref("Event")}}._
- {{domxref("CustomEvent.detail")}} {{ReadOnlyInline}}
- : Returns any data passed when initializing the event.
Instance methods
_This interface inherits methods from its parent, {{domxref("Event")}}._
- {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}}
- : Initializes a
CustomEventobject. If the event has already been dispatched, this method does nothing.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("Window.postMessage()")}}
- Creating and dispatching events