本記事では、JavaScriptのaddEventListenerメソッドで登録したイベントを削除する方法について解説しています。
JavaScriptの学習におすすめ参考書
改訂3版JavaScript本格入門 ～モダンスタイルによる基礎から現場での応用まで
| 出版社 | 技術評論社 |
|---|---|
| 著者 | 山田 祥寛 |
| 発売日 | 2023/2/13 |
| ページ数 | 624ページ |
| レビュー (Amazon) | (4件) |
綺麗なコードが書けるようになる！
リーダブルコード-より良いコードを書くためのシンプルで実践的なテクニック
| 出版社 | オライリージャパン |
|---|---|
| 著者 | Dustin Boswell / Trevor Foucher |
| 発売日 | 2012/6/23 |
| ページ数 | 260ページ |
| レビュー (Amazon) | (620件) |
removeEventListenerメソッド
一度設定したイベントリスナーを削除したい場合は、removeEventListenerメソッドを使用します。基本的な使い方は以下のとおりです。
removeEventListener(type, listener, useCapture);- type：イベントの種類を指定
- listener：イベント発生時に処理をしたいコードを記述
- useCapture：キャプチャフェーズまたはバブリングフェーズの選択(省略可能：デフォルト値はfalse)
removeEventListenerメソッドの引数は、イベント登録で使い慣れているaddEventListenerメソッドと全く同じと思って頂いて問題ないです。
実際に、addEventListenerメソッドを使用して登録したイベントリスナーを削除するサンプルコードを用意したので、動作確認してみましょう。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
</head>
<body>
<input id="btn" type="button" value="ボタン" />
<script src="index.js"></script>
</body>
</html>let btn = document.querySelector("#btn");
const callLog = () => console.log("ボタンがクリックされました！");
btn.addEventListener("click", callLog, false);上記のコードは、現状ボタンをクリックするとコンソールログに「ボタンがクリックされました！」の文字が出力されます。最後の行に下記のremoveEventListenerメソッドを追加してみます。
btn.removeEventListener("click", callLog, false);すると、ボタンをクリックしてもコンソールログに何も表示がされなくなります。これで設定したイベントが削除されたことが確認できました。
removeEventListenerメソッドの注意点
removeEventListenerメソッドを使う注意点は2つあります。
1つ目は、addEventListenerメソッドでイベントが定義された後に記述する必要があります。下記のコードのように、定義される前に記述をした場合は削除対象のイベントが見つからないと判断されてしまいます。
btn.removeEventListener("click", callLog, false); // => イベント削除のコード
btn.addEventListener("click", callLog, false); // => イベント登録のコード2つ目は、第三引数のboolean値を必ず同じにすることです。下記のコードのようにaddEventListenerメソッドではfalseを指定し、removeEventListenerメソッドではtrueを指定した場合は異なるイベントだと判断され削除がされません。
btn.addEventListener("click", callLog, false);
btn.removeEventListener("click", callLog, true);
1冊ですべて身につくHTML & CSSとWebデザイン入門講座 
