DocumentEvent インターフェイスは、実装にサポートされている型のイベントをユーザが作成できるメカニズムを提供する。イベントモデルをサポートする実装において、Document インターフェイスを実装するオブジェクトと同じオブジェクト上に、 DocumentEvent インターフェイスが実装されていることが期待される。
createEvent( eventType )
eventType パラメータは作成する Event インターフェイスの型を指定する。指定された Event インターフェイスが実装によってサポートされている場合は、このメソッドは要求されたインターフェイス型の新しい Event を返す。 Event が dispachEvent メソッド経由で送信されている場合は、 Event の値の初期化のために、作成後に適切なイベント初期化メソッドが呼ばれなければならない。例として、ある種の UIEvent を合成したいユーザは、パラメータ "UIEvents" をとる createEvent を呼ぶ。送信される特定の型の UIEvent の設定、そして文脈情報の設定のために、新しく作成された UIEvent 上で initUIEvent メソッドを呼ぶこともできる。ユーザにとってイベントの作成が不便であり、また不必要であるとき createEvent メソッドは Event の作成に使用される。 Event を提供する実装が不十分な場合は、ユーザは dispatchEvent メソッドに伴って使用するために、彼ら自身の Event の実装を供給してもよい。
Event interface
requested
// Introduced in DOM Level 2:
interface DocumentEvent {
Event createEvent(in DOMString eventType)
raises(DOMException);
};