Event createEvent(String eventType) throws DOMException;
eventType
The name of the event module for which an Event object is desired. See the Section section for a list of valid event types.
A newly created Event object of the specified type.
This method throws a DOMException with a code of NOT_SUPPORTED_ERR if the implementation does not support events of the requested type.
This method creates a new event type of the type specified by the eventType argument. Note that the value of this argument should not be the (singular) name of the event interface to be created, but instead should be the (plural) name of the DOM module that defines that interface. The following table shows the legal values for eventType and the event interface each value creates.
|
eventType argument |
Event interface |
Initialization method |
|---|---|---|
|
HTMLEvents |
Event |
initEvent( ) |
|
MouseEvents |
MouseEvent |
initMouseEvent( ) |
|
UIEvents |
UIEvent |
initUIEvent( ) |
|
MutationEvents |
MutationEvent |
initMutationEvent( ) |
After creating an Event object with this method, you must initialize the object with the initialization method shown in the table. See the appropriate Event interface reference page for details about the initialization method.
This method is actually defined not by the Document interface but by the DocumentEvent interface. If an implementation supports the Events module, the Document object always implements the DocumentEvent interface and supports this method.
Event, MouseEvent, MutationEvent, UIEvent