JavaScript

JavaScript dispatchEvent method.

dispatchEvent

　特定の EventTargetに Eventをディスパッチし、影響する EventListenerを適切な順序で呼び出します。通常のイベント処理ルール（capturingフェーズと任意的な bubblingフェーズを含む）は dispatchEvent()で手動でディスパッチされたイベントにも適用されます。

構文

cancelled = !target.dispatchEvent(event)

• event は、ディスパッチされる Event オブジェクトです。
• target は Event.target を初期化し、どのイベントリスナーを呼び出すかを決定するのに使われます。
• このイベントを処理した少なくともひとつのイベントハンドラが Event.preventDefault() を呼び出した場合、戻り値は false となります。そうでなければ true となります。

　もしメソッド呼び出しの前にイベントが初期化されず、イベントのタイプが指定されなかった場合、あるいはイベントのタイプが nullまたは空文字列だった場合、dispatchEventは UNSPECIFIED_EVENT_TYPE_ERRを投げます。イベントハンドラから投げられた例外は、キャッチされなかった例外として報告されます。イベントハンドラは入れ子のコールスタック上で実行され、実行が完了するまで呼び出し元をブロックしますが、例外は呼び出し元まで伝播しません。