2.1.7 [DOM Level 2 - Events] Section 1.5, DocumentEvent interface

  • Article

V0023:

The specification states:

DocumentEvent interface provides a mechanism by which the user can create an 
Event of a type supported by the implementation. It is expected that the 
DocumentEvent interface will be implemented on the same object which implements 
the Document interface in an implementation which supports the Event model.
 
IDL Definition// Introduced in DOM Level 2:
 
interface DocumentEvent {
Event createEvent(in DOMString eventType)raises(DOMException);
};

Quirks Mode, IE7 Mode, and IE8 Mode (All Versions)

The DocumentEvent interface is not implemented. Similar functionality is provided by the createEventObject([oExistingEvent]) scripting method. Individual events are requested and set according to their name.

Parameters:

oExistingEvent Optional. An object that specifies an existing event object on which to base the new object.

Return value:

Returns an event object.

Event object properties are read-only once the fireEvent method is called.