JavaScript

【JavaScript】設定したイベントリスナーを削除する方法

本記事では、JavaScriptのaddEventListenerメソッドで登録したイベントを削除する方法について解説しています。

JavaScriptの学習におすすめ参考書
改訂3版JavaScript本格入門 ~モダンスタイルによる基礎から現場での応用まで

本書情報
出版社技術評論社
著者山田 祥寛
発売日2023/2/13
ページ数624ページ
レビュー
(Amazon)
(4件)
先輩くん
先輩くん
10万部突破したJavaScriptの本が大幅増補改訂し7年ぶりに発売されたよ!
後輩ちゃん
後輩ちゃん
最新の基本文法から、開発に欠かせない応用トピックまで学ぶことが出来るよ!

綺麗なコードが書けるようになる!
リーダブルコード-より良いコードを書くためのシンプルで実践的なテクニック

本書情報
出版社オライリージャパン
著者Dustin Boswell / Trevor Foucher
発売日2012/6/23
ページ数260ページ
レビュー
(Amazon)
(620件)
先輩くん
先輩くん
より良いコードを書きたい人におすすめの本だよ!
後輩ちゃん
後輩ちゃん
10以上前の書籍ですが、内容は今でも役に立つものばかりです!

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);

ブログランキング・にほんブログ村へ PVアクセスランキング にほんブログ村