--- title: Document.createEvent() slug: Web/API/Document/createEvent tags: - API - DOM - Document - Method - Reference - createEvent - メソッド translation_of: Web/API/Document/createEvent ---

initCustomEvent など、createEvent とともに使用される多くのメソッドは非推奨です。代わりに イベントのコンストラクター を使用してください。

{{ApiRef("DOM")}}

指定された型の イベント を作成します。返されるオブジェクトは最初に初期化する必要があり、その後で {{domxref("EventTarget.dispatchEvent")}} へ渡すことができます。

構文

var event = document.createEvent(type);

// イベントを作成します。
var event = document.createEvent('Event');

// イベントの名前を 'build' に定義します。
event.initEvent('build', true, true);

// イベントを待受します。
elem.addEventListener('build', function (e) {
  // e.target が elem に対応する
}, false);

// ターゲットは任意の Element やほかの EventTarget にすることができます。
elem.dispatchEvent(event);

createEvent() に渡すのに適したイベント型を表す文字列は DOM 標準で定義されています。ステップ 2 の表をご覧ください。現在はほとんどのイベントオブジェクトにコンストラクターがあり、それらはイベントオブジェクトのインスタンスを生成するために推奨される、現代的な方法であることに注意してください。

Gecko は非標準のイベントオブジェクトの別名をサポートしています。詳細は以下の表を参照してください。

イベントモジュール 標準イベントオブジェクト Gecko が対応する別名
テキストイベントモジュール TextEvent TextEvents
キーボードイベントモジュール KeyboardEvent KeyEvents
基本イベントモジュール Event Events

仕様書

仕様書 状態 備考
{{SpecName('DOM WHATWG', '#dom-document-createevent', 'document.createEvent')}} {{Spec2('DOM WHATWG')}}

ブラウザーの互換性

{{Compat("api.Document.createEvent")}}

関連情報