--- title: Event slug: Web/API/Event tags: - API - DOM - Event - Interface - Reference - UI - インターフェイス translation_of: Web/API/Event ---

{{APIRef("DOM")}}

Event インターフェイスは、DOM で発生するイベントを表します。ユーザーによって発生するイベント (マウスやキーボードのイベント) もありますし、API によって発生するイベント (アニメーションの実行が完了したことを示すイベントや、動画再生が一時停止したイベントなど) もあります。さまざまな型のイベントがあり、一部のイベントは基底の Event インターフェイスを基にした他のインターフェイスを使用します。Event 自体は、すべてのイベントで共通のプロパティやメソッドを持ちます。

Event を基にしたインターフェイス

以下のリストは Event インターフェイスを基にしたインターフェイスの一覧であり、 MDN API リファレンスの各ドキュメントにリンクしています。すべてのイベントインターフェイスは、名称の末尾が "Event" であることに留意してください。

コンストラクター

{{domxref("Event.Event", "Event()")}}
Event オブジェクトを生成して、呼び出し元に返します。

プロパティ

{{domxref("Event.bubbles")}} {{readonlyinline}}
イベントが DOM を通して浮上 (bubble up) するかを示す boolean 値です。
{{domxref("Event.cancelBubble")}}
{{domxref("Event.stopPropagation()")}} の歴史的な別名です。イベントハンドラーから戻る前に値 true を設定すると、イベントの伝播を抑制します。
{{domxref("Event.cancelable")}} {{readonlyinline}}
イベントがキャンセル可能かを示す boolean 値です。
{{domxref("Event.composed")}} {{ReadOnlyInline}}
shadow DOM と 通常の DOM の間の境界を越えてイベントが伝播できるかをを示す Boolean 値です。
{{domxref("Event.currentTarget")}} {{readonlyinline}}
イベントが現在登録されているターゲットへの参照。これは、現在イベントの送信先として予定されているオブジェクトです。これはリターゲティングによって、途中で変更できます。
{{domxref("Event.deepPath")}} {{non-standard_inline}}
イベントの伝播で通り抜けた DOM {{domxref("Node")}} の {{jsxref("Array")}} です。
{{domxref("Event.defaultPrevented")}} {{readonlyinline}}
{{domxref("event.preventDefault()")}} がイベントで呼ばれたかどうかを示します。
{{domxref("Event.eventPhase")}} {{readonlyinline}}
イベントの流れのうちどの段階が処理されているかを示します。
{{domxref("Event.explicitOriginalTarget")}} {{non-standard_inline}} {{readonlyinline}}
イベントの明確な最初のターゲット (Mozilla 特有)。
{{domxref("Event.originalTarget")}} {{non-standard_inline}} {{readonlyinline}}
イベントの再ターゲット前の最初のターゲット (Mozilla 特有)。
{{domxref("Event.returnValue")}}
Internet Explorer によって導入された歴史的なプロパティで、既存のサイトが動作し続けることを保証するために結果的に DOM 仕様書に導入されたものです。理想的には、 {{domxref("Event.preventDefault()")}} および {{domxref("Event.defaultPrevented")}} を代わりに使用してみるべきですが、選択次第では returnValue を使用することができます。
{{domxref("Event.srcElement")}} {{non-standard_inline}}
{{domxref("Event.target")}} の、(古いバージョンの Microsoft Internet Explorer 由来の) 標準外の別名であり、ウェブの互換性の目的で一部の他のブラウザーでも対応が始められています。
{{domxref("Event.target")}} {{readonlyinline}}
イベントが最初に送出されたターゲットへの参照。
{{domxref("Event.timeStamp")}} {{readonlyinline}}
イベントが生成された時刻をミリ秒単位で示します。仕様書ではこの値をエポックから経過した時間としていますが、実際のブラウザの定義は異なります。また、値を {{domxref("DOMHighResTimeStamp")}} に変更する作業が進行中です。
{{domxref("Event.type")}} {{readonlyinline}}
イベントの名前 (大文字小文字を区別しません)。
{{domxref("Event.isTrusted")}} {{readonlyinline}}
イベントがブラウザーによって開始されたか (たとえばユーザークリックの後)、または、スクリプトによって開始されたか (event.initEvent のようなイベントを作るメソッドの使用) どうかを示します。

廃止されたプロパティ

{{domxref("Event.scoped")}} {{readonlyinline}} {{obsolete_inline}}
{{jsxref("Boolean")}} で、指定されたイベントが標準 DOM の中のシャドウルートを通してバブルするかどうかを示します。このプロパティは {{domxref("Event.composed", "composed")}} に改名されました。

メソッド

{{domxref("Event.createEvent()")}} {{deprecated_inline}}

新しいイベントを作成し、これはその後で initEvent() メソッドを呼び出すことで初期化する必要があります。

{{domxref("Event.composedPath()")}}
(リスナーが呼び出されるオブジェクトへの) イベントのパスを返します。これはシャドウルートが {{domxref("ShadowRoot.mode")}} が閉じた状態で作成されたシャドウツリーのノードを含みません。
{{domxref("Event.initEvent()")}} {{deprecated_inline}}
生成されたイベントの値を初期化します。イベントがすでにディスパッチされている場合は、何も行いません。
{{domxref("Event.preventDefault()")}}
イベントをキャンセルします (キャンセル可能な場合のみ)。
{{domxref("Event.stopImmediatePropagation()")}}
この特定のイベントのために、他のいかなるリスナーも呼び出されません。同じ要素に付けられたリスナーも、後で横断される(たとえばキャプチャー段階の) 要素に付けられたリスナーも呼び出されません。
{{domxref("Event.stopPropagation()")}}
これ以上イベントが 伝播 (propagation) するのを停止します。

廃止されたメソッド

{{domxref("Event.getPreventDefault()")}} {{non-standard_inline}}
標準外です。{{domxref("Event.defaultPrevented")}} の値を返します。代わりに {{domxref("Event.defaultPrevented")}} を使用してください。
{{domxref("Event.preventBubble()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}
イベントが 浮上 (bubble up) しないようにします。廃止されたので、代わりに {{domxref("event.stopPropagation")}} を使ってください。
{{domxref("Event.preventCapture()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}
廃止されたので、{{domxref("event.stopPropagation")}} を使ってください。

仕様書

仕様書 状態 備考
{{SpecName('DOM WHATWG', '#interface-event', 'Event')}} {{Spec2('DOM WHATWG')}}  

ブラウザーの対応

{{Compat("api.Event")}}

関連情報