仕様書

[7] DOM Standard (2013-04-26 20:00:45 +09:00 版) https://dom.spec.whatwg.org/#interface-event
- [79] DOM Standard (2018-03-16 19:20:53 +09:00) https://dom.spec.whatwg.org/#constructing-events
[61] HTML Standard (2016-12-13 09:04:33 +09:00) https://html.spec.whatwg.org/#dom-messageevent-initmessageevent

状態

[8] イベントは次の状態を持ちます。

インターフェイス: Event か、それを継承したインターフェイスを使います。
型イベント型
対象イベント対象
[11] currentTarget 属性
[29] bubbles
[30] cancelable
[12] 伝播停止フラグ
[13] 直ちに伝播停止フラグ
[14] 取り消し済みフラグ
[15] 初期化済みフラグ
[16] 派遣フラグ
受動的リスナー内フラグ: 受動的なイベントリスナーの処理中かどうかのフラグです。 preventDefault メソッドの動作に影響します。
[17] isTrusted 属性
[18] timeStamp 属性
相: capturing, at target, bubbling のどの段階かを表します。
経路イベント経路
合成フラグ
関連対象
item-in-shadow-tree

[19] Event を継承する子インターフェイスは、それぞれの追加の状態を持ちます。

メンバー

[44] Event インターフェイスは次のメンバーを持ちます。

composed
currentTarget
eventPhase
targetevent target
srcElement
NONEeventPhase
CAPTURING_PHASE
AT_TARGET
BUBBLING_PHASE
cancelBubble
returnValue

子インターフェイス

[20] Event を継承した子インターフェイスはたくさんあります。

CloseEvent
CustomEvent
KeyboardEvent
MouseEvent
MutationEvent
ProgressEvent
UIEvent
ErrorEvent
PopStateEvent
HashChangeEvent
PageTransitionEvent
PromiseRejectionEvent
BeforeUnloadEvent
DeviceOrientationEvent
DeviceMotionEvent
MessageEvent

AutocompleteErrorEvent
LSProgressEvent
SVGZoomEvent
UIRequestEvent

イベントの生涯

[31] イベントは次のように進行します。

[32] イベントの作成
[33] 初期化 (>>21)
[34] dispatch
[35] 既定動作

[36]

>>35 は DOM3 までは存在していましたが、 DOM Standard では明示的に言及していません。ただし概念的に相当するものは現在も残っています。

[37] Webブラウザーにより生成されるイベントは通常「発火」によって >>32、>>33、>>34 が順に行われ、その後 >>35 が存在すれば実行されることになります。

[38] DOM2 と DOM3 の処理モデルによれば >>32 は createEvent、 >>33 は initEvent 系メソッド、 >>34 は dispatchEvent によって実行でき、 >>34 の返り値によって >>35 の実行可否を判断できることになっていました。現在でも著者による JavaScript コードはこの流れでイベントを実行させられますが、古い方法となっています。

[39] DOM Standard によれば >>32 と >>33 は Event のコンストラクターにより実行でき、 >>34 と >>35 は >>38 同様に dispatchEvent を利用できます。ただし >>37 の場合とは isTrusted の値が変わりますから、著者による JavaScript が Webブラウザーと同一のイベントを発生させることは現在ではできなくなっています。

[40] Event インターフェイスとそれを継承するほとんどのインターフェイスは、コンストラクターを持ちます。

[41] BeforeUnloadEvent インターフェイスは、コンストラクターを持ちません。

作成

[80] イベントオブジェクトの作成は、イベントコンストラクターによるもの (>>59)、 createEvent によるもの、その他利用者エージェントによるものの3通りの方法に大別できます。

[81] 利用者エージェントによるイベントオブジェクトの作成と createEvent は、イベントの作成の方法に従ってイベントオブジェクトを作成します。

[47] イベントの作成create an eventは、 Event またはその子インターフェイスイベントインターフェイスと Realm realm (既定値 null) について、次のようにします >>79。

[83] イベントを、内部イベント作成手順群を実行した結果に設定します。
イベントインターフェイス
イベントインターフェイス
realm
realm
時刻
本イベントの表す事項の発生した時刻
辞書
JavaScript値 undefined をイベントインターフェイスのコンストラクターの第2引数の辞書型に変換変換 (Web IDL)した結果
[82] イベントの isTrusted を、真に設定します。
[84] イベントを返します。

[74] 例えば Mac OS X の入力イベント由来の場合、 NSEvent の timestamp を時刻として使えます >>79。

[85]

createEvent はイベントの作成で得られたイベントオブジェクトの isTrusted を偽に設定します。

[55] イベントの作成は色々な場面で呼び出されます。

[86]

イベントを作成する文脈

発火
合成マウスイベントを発火
beforeunload
postMessage
createEvent

[87] 内部イベント作成手順群inner event creation stepsは、 イベントインターフェイス、 realmRealm、 時刻、 辞書について、次のようにします >>79。

[88] イベントを、新しいオブジェクトに設定します。
- realm が null 以外の場合、 realm をオブジェクトの Realm として使います。
- realm が null の場合、 Web IDL の既定の動作とします。
[89] イベントの初期化済みフラグを、真に設定します。
[90] イベントの timeStamp を、時刻起源から時刻までの高精度時刻を表す DOMHighResTimeStamp に設定します。
[48] 辞書の各 (名前、値) について、
1. [49] イベントの 名前 を、 値に設定します。
[97] イベントのイベント構築手順群event constructing stepsを実行します。 イベントインターフェイスにより、
その他の場合
何もしません。
[50] イベントを返します。

[56]

DeviceMotionEvent では初期化の辞書の辞書メンバーが辞書で、 IDL属性がその辞書から初期化されるオブジェクトとなっていますから、単なる値のコピーではない操作が必要です。

[51] イベントの作成とイベントコンストラクターから呼び出されます。

初期化

[21] イベントは作成されたあと初期化initializeする必要があります。初期化により type, bubbles, cancelable の値が設定されます。またイベント型依存の各種の値も同時に設定されます。

[22] 初期化すると初期化済みフラグinitialized flagが設定されます。

[23] 初期化は派遣フラグが設定されるまでは何度でも行えます。

[24] 初期化は2通りの方法で実行できます。

[25] Event や子インターフェイスの構築子により、オブジェクト生成と同時に行う
[26] initEvent メソッドで行う

[27] >>26 は DOM2 から用意されていた方法です。また当初 DOM3 では initEventNS メソッドも定義されていました。更に、 Event の子インターフェイスはそれぞれ initMouseEvent や initMouseEventNS のようなメソッドを定義していました。

[28] >>26 は 2012年頃に DOM Standard に追加された方法です。初期の DOMイベントの実装には存在していません。現在ではこちらの方法を使うのが望ましいとされ、 initEvent 系のメソッドは互換性のために必要なものを除き仕様からも削除されています。

イベントコンストラクター

[59] Event インターフェイスとその子インターフェイスは、一部の例外を除き、コンストラクターを持ちます。

[60] Event コンストラクター (new Event) は引数で EventInit 辞書を受け取ることができます。コンストラクターを持つ子インターフェイスも、それぞれに対応する辞書 () が存在し、それを引数で受け取ることができます。

[53] Event またはその子インターフェイスインターフェイスのコンストラクターが呼び出されたら、次のようにしなければなりません >>79。

[72] イベント型を、第1引数を DOMString と解釈した結果に設定します。
[91] 辞書を、辞書型 (EventInit またはそれを継承する辞書であり、具体的にはインターフェイス依存。必須か否かもインターフェイス依存。) と解釈した結果に設定します。
[92] イベントを、内部イベント作成手順群を実行した結果に設定します。
イベントインターフェイス
インターフェイス
realmRealm
null
時刻
現在現在時刻
辞書
辞書
[93] イベントの型イベント型を、 イベント型に設定します。
[94] イベントを返します。

PushEvent

`initEvent` メソッド

[62] MessageEvent インターフェイスの initMessageEvent メソッドは、引数としてイベント型、bubbles、取り消し可能、 dataMessageEvent、 originMessageEvent、 lastEventId、 sourceMessageEvent、 ports を受け取ります >>61。

initStorageEvent

メンバー

[1]
altKey HTMLEventObj (Trident)
altLeft HTMLEventObj3 (Trident)
behaviorCookie HTMLEventObj3 (Trident)
behaviorPart HTMLEventObj3 (Trident)
bookmarks HTMLEventObj2 (Trident)
boundElements HTMLEventObj2 (Trident)
button HTMLEventObj (Trident)
cancelBubble HTMLEventObj (Trident)
clientX HTMLEventObj (Trident)
clientY HTMLEventObj (Trident)
contentOverflow HTMLEventObj3 (Trident)
ctrlKey HTMLEventObj (Trident)
ctrlLeft HTMLEventObj3 (Trident)
data event (JavaScript 1.2)
dataFld HTMLEventObj2 (Trident)
dataTransfer HTMLEventObj2 (Trident)
fromElement HTMLEventObj (Trident)
getAttribute HTMLEventObj2 (Trident)
height event (JavaScript 1.2)
imeCompositionChange HTMLEventObj3 (Trident)
imeNotifyCommand HTMLEventObj3 (Trident)
imeNotifyData HTMLEventObj3 (Trident)
imeRequest HTMLEventObj3 (Trident)
imeRequestData HTMLEventObj3 (Trident)
keyboardLayout HTMLEventObj3 (Trident)
keyCode HTMLEventObj (Trident)
layerX event (JavaScript 1.2)
layerY event (JavaScript 1.2)
modifiers event (JavaScript 1.2)
nextPage HTMLEventObj3 (Trident)
offsetX HTMLEventObj (Trident)
offsetY HTMLEventObj (Trident)
pageX event (JavaScript 1.2)
pageY event (JavaScript 1.2)
propertyName HTMLEventObj2 (Trident)
qualifier HTMLEventObj (Trident)
reason HTMLEventObj (Trident)
recordset HTMLEventObj2 (Trident)
removeAttribute HTMLEventObj2 (Trident)
repeat HTMLEventObj2 (Trident)
returnValue HTMLEventObj (Trident)
screenX HTMLEventObj (Trident), event (JavaScript 1.2)
screenY HTMLEventObj (Trident), event (JavaScript 1.2)
setAttribute HTMLEventObj2 (Trident)
shiftKey HTMLEventObj (Trident)
shiftLeft HTMLEventObj3 (Trident)
srcElement HTMLEventObj (Trident)
srcFilter HTMLEventObj (Trident)
srcUrn HTMLEventObj2 (Trident)
target event (JavaScript 1.2)
toElement HTMLEventObj (Trident)
type HTMLEventObj (Trident), event (JavaScript 1.2)
wheelDelta HTMLEventObj4 (Trident)
which event (JavaScript 1.2)
width event (JavaScript 1.2)
x HTMLEventObj (Trident), event (JavaScript 1.2)
y HTMLEventObj (Trident), event (JavaScript 1.2)

[2] [whatwg] Enhancement request: change EventSource to allow cross-domain access ( (2011-06-18 08:38:12 +09:00 版)) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-June/032152.html

[3] Simplified initializing of synthetic events — Anne’s Blog (2011-06-23 18:44:14 +09:00 版) http://annevankesteren.nl/2011/06/initializing-events

[4] Simplified initializing of synthetic events — Anne’s Blog (2011-06-23 18:44:14 +09:00 版) http://annevankesteren.nl/2011/06/initializing-events

[5] IRC logs: freenode / #whatwg / 20110926 ( (2011-09-28 23:19:21 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20110926

[6] XBL 2.0 ( (2012-05-03 02:23:03 +09:00 版)) http://dev.w3.org/2006/xbl2/Overview.html#the-eventxbl-interface

[42] Editorial: define Event attribute defaults through IDL · whatwg/html@0be0229 (2016-03-23 21:13:32 +09:00 版) https://github.com/whatwg/html/commit/0be02299f128cbb7c65a7ce259fdd838fd44a4b5

[43] Change IDL for OnErrorEventHandlerNonNull from column to colno by zcorpan · Pull Request #1331 · whatwg/html ( (2016-05-28 13:37:16 +09:00)) https://github.com/whatwg/html/pull/1331

[45] Editorial: provide a shorthand for other specifications to create events (annevk著, 2016-10-24 18:11:36 +09:00) https://github.com/whatwg/dom/commit/e728c11c4aeab35573f0d77270066202f8739475

[46] Add a realm argument to "create an event" (domenic著, 2016-10-27 15:30:55 +09:00) https://github.com/whatwg/dom/commit/64444fad86d3820663744a876e92ce69276313db

[54] Editorial: use "creating an event" more and refactor click() (annevk著, 2016-10-29 03:23:16 +09:00) https://github.com/whatwg/html/commit/467b98781f82f6bf1a91fad435982ff27d8d9999

[57] Check dispatch flag before initializing https://www.w3.org/Bugs/Public/s... · ccacdec · whatwg/dom (2014-11-22 17:42:43 +09:00 版) https://github.com/whatwg/dom/commit/ccacdec1b3c99019677e8737c8f8550583984e67

[58] Fix issue 44: initFocusEvent not needed · w3c/uievents@b5c7942 (2016-01-21 11:54:20 +09:00 版) https://github.com/w3c/uievents/commit/b5c7942ee5b75ae7e213f12107a12ae0ce2e84fb

[63] Web Applications 1.0 r8711 Add initMessageEvent() ( (2014-08-06 07:33:00 +09:00 版)) http://html5.org/r/8711

[64] Tweak nullability in initMessageEvent() and MessageEventInit · whatwg/html@99f79f2 (2015-09-03 14:45:41 +09:00 版) https://github.com/whatwg/html/commit/99f79f20c4033d0db4bc4e5c9609c6a3e23cbbe0

[65] Use USVString for all URLs ( (domenic著, 2016-05-20 22:02:29 +09:00)) https://github.com/whatwg/html/commit/018b983b77b2cd908f6d00100e7e0abe893dd2c3

[66] Make initEvent()/initCustomEvent() arguments optional except the first (cdumez著, 2017-03-07 17:31:38 +09:00) https://github.com/whatwg/dom/commit/23587350d4ba2bb878ffdd4e94a8050213b71751

[67] Specify the arguments of initCompositionEvent() · Issue #134 · w3c/uievents (2017-03-08 14:43:11 +09:00) https://github.com/w3c/uievents/issues/134

[68] Specify the arguments of initMouseEvent() · Issue #136 · w3c/uievents (2017-03-08 14:43:33 +09:00) https://github.com/w3c/uievents/issues/136

[69] Clearly specify initUIEvent · Issue #133 · w3c/uievents (2017-03-08 14:44:12 +09:00) https://github.com/w3c/uievents/issues/133

[70] Make parameters to initMessageEvent() optional except the first (cdumez著, 2017-03-07 17:39:08 +09:00) https://github.com/whatwg/html/commit/2dafd2fbf9b08e58f126b112ef26aff4cb84b954

[71] Make Event's timeStamp use DOMHighResTimeStamp (majido著, 2017-07-13 16:38:55 +09:00) https://github.com/whatwg/dom/commit/912d58746bc4c67c2fd210124639f7c34991fce5

[73] Make Event's timeStamp use DOMHighResTimeStamp (majido著, 2017-07-13 16:38:55 +09:00) https://github.com/whatwg/dom/commit/912d58746bc4c67c2fd210124639f7c34991fce5

[75] Expose Event and EventTarget to AudioWorklet (hoch著, 2017-09-30 18:22:32 +09:00) https://github.com/whatwg/dom/commit/601655d48abe3979200e42cefad60cdf0d752693

[76] [audioworklet] Ensure MessagePort is exposed in audio worklets · Issue #1266 · WebAudio/web-audio-api (2017-10-01 16:24:54 +09:00) https://github.com/WebAudio/web-audio-api/issues/1266

[77] Expose Event, EventTarget to AudioWorklet · Issue #515 · whatwg/dom (2017-10-01 16:25:59 +09:00) https://github.com/whatwg/dom/issues/515

[78] Fix 515: Expose Event, EventTarget to AudioWorklet by hoch · Pull Request #516 · whatwg/dom (2017-10-01 16:26:16 +09:00) https://github.com/whatwg/dom/pull/516

[52] Make the two ways of event creation share a path (annevk著, 2018-03-16 16:57:36 +09:00) https://github.com/whatwg/dom/commit/0283565d2a3f767befd368248b788b5f5803baf2

[95] Make the two ways of event creation share a path by annevk · Pull Request #603 · whatwg/dom (2018-03-18 01:00:51 +09:00) https://github.com/whatwg/dom/pull/603

[96] Define event constructing steps (annevk著, 2018-04-06 23:05:05 +09:00) https://github.com/whatwg/dom/commit/4c95d89624f695e9d74fd545b004ae85ca3cd6b6

[98] "create an event" doesn't work for certain UI events · Issue #414 · whatwg/dom (2018-04-07 16:02:39 +09:00) https://github.com/whatwg/dom/issues/414

[99] Define event constructing steps by annevk · Pull Request #614 · whatwg/dom (2018-04-07 16:07:15 +09:00) https://github.com/whatwg/dom/pull/614

[100] Define "event constructing steps" for complicated events · Issue #194 · w3c/uievents (2018-04-07 16:07:31 +09:00) https://github.com/w3c/uievents/issues/194

[101] Define init*Event() methods imperatively · Issue #191 · w3c/uievents (2018-04-07 16:08:30 +09:00) https://github.com/w3c/uievents/issues/191

[9] Add initStorageEvent() (foolip著, 2018-10-04 05:47:37 +09:00) https://github.com/whatwg/html/commit/18ca10633ffbcbe2a95dd1d42dfb04c798cc5700

[10] Add more init*Event()? · Issue #1054 · whatwg/html (2018-10-22 01:22:41 +09:00) https://github.com/whatwg/html/issues/1054

[102] Add initStorageEvent() by foolip · Pull Request #4063 · whatwg/html (2018-10-22 01:23:08 +09:00) https://github.com/whatwg/html/pull/4063

[103] Align with IDL dictionary changes (annevk著, 2019-08-09 00:54:02 +09:00) https://github.com/whatwg/dom/commit/c15e65f193ab7561485606158c72f491c67f4b11

[104] Align with IDL constructor changes (autokagami著, 2019-09-24 22:42:56 +09:00) https://github.com/whatwg/dom/commit/57512fac17cf2f1c4c85be4aec178c8086ee5ee4

[105] Update to constructor operations · Issue #780 · whatwg/dom (2020-05-14 14:04:36 +09:00) https://github.com/whatwg/dom/issues/780

`altKey`	`HTMLEventObj` (Trident)
`altLeft`	`HTMLEventObj3` (Trident)
`behaviorCookie`	`HTMLEventObj3` (Trident)
`behaviorPart`	`HTMLEventObj3` (Trident)
`bookmarks`	`HTMLEventObj2` (Trident)
`boundElements`	`HTMLEventObj2` (Trident)
`button`	`HTMLEventObj` (Trident)
`cancelBubble`	`HTMLEventObj` (Trident)
`clientX`	`HTMLEventObj` (Trident)
`clientY`	`HTMLEventObj` (Trident)
`contentOverflow`	`HTMLEventObj3` (Trident)
`ctrlKey`	`HTMLEventObj` (Trident)
`ctrlLeft`	`HTMLEventObj3` (Trident)
`data`	`event` (JavaScript 1.2)
`dataFld`	`HTMLEventObj2` (Trident)
`dataTransfer`	`HTMLEventObj2` (Trident)
`fromElement`	`HTMLEventObj` (Trident)
`getAttribute`	`HTMLEventObj2` (Trident)
`height`	`event` (JavaScript 1.2)
`imeCompositionChange`	`HTMLEventObj3` (Trident)
`imeNotifyCommand`	`HTMLEventObj3` (Trident)
`imeNotifyData`	`HTMLEventObj3` (Trident)
`imeRequest`	`HTMLEventObj3` (Trident)
`imeRequestData`	`HTMLEventObj3` (Trident)
`keyboardLayout`	`HTMLEventObj3` (Trident)
`keyCode`	`HTMLEventObj` (Trident)
`layerX`	`event` (JavaScript 1.2)
`layerY`	`event` (JavaScript 1.2)
`modifiers`	`event` (JavaScript 1.2)
`nextPage`	`HTMLEventObj3` (Trident)
`offsetX`	`HTMLEventObj` (Trident)
`offsetY`	`HTMLEventObj` (Trident)
`pageX`	`event` (JavaScript 1.2)
`pageY`	`event` (JavaScript 1.2)
`propertyName`	`HTMLEventObj2` (Trident)
`qualifier`	`HTMLEventObj` (Trident)
`reason`	`HTMLEventObj` (Trident)
`recordset`	`HTMLEventObj2` (Trident)
`removeAttribute`	`HTMLEventObj2` (Trident)
`repeat`	`HTMLEventObj2` (Trident)
`returnValue`	`HTMLEventObj` (Trident)
`screenX`	`HTMLEventObj` (Trident), `event` (JavaScript 1.2)
`screenY`	`HTMLEventObj` (Trident), `event` (JavaScript 1.2)
`setAttribute`	`HTMLEventObj2` (Trident)
`shiftKey`	`HTMLEventObj` (Trident)
`shiftLeft`	`HTMLEventObj3` (Trident)
`srcElement`	`HTMLEventObj` (Trident)
`srcFilter`	`HTMLEventObj` (Trident)
`srcUrn`	`HTMLEventObj2` (Trident)
`target`	`event` (JavaScript 1.2)
`toElement`	`HTMLEventObj` (Trident)
`type`	`HTMLEventObj` (Trident), `event` (JavaScript 1.2)
`wheelDelta`	`HTMLEventObj4` (Trident)
`which`	`event` (JavaScript 1.2)
`width`	`event` (JavaScript 1.2)
`x`	`HTMLEventObj` (Trident), `event` (JavaScript 1.2)
`y`	`HTMLEventObj` (Trident), `event` (JavaScript 1.2)

仕様書

状態

メンバー

子インターフェイス

イベントの生涯

作成

初期化

イベントコンストラクター

initEvent メソッド

メンバー

`initEvent` メソッド