JavaScript: The Definitive Guide, Fourth Edition

Name

EventTarget.removeEventListener( ) — delete an event listener

Availability

DOM Level 2 Events

Synopsis

v
oid removeEventListener(String type,
                        EventListener listener, 
                        boolean useCapture);

Arguments

type

The type of event for which the event listener is to be deleted.

listener

The event listener function that is to be removed.

useCapture

true if a capturing event listener is to be removed; false if a normal event listener is to be removed.

Description

This method removes the specified event listener function. The type and useCapture arguments must be the same as they were in the corresponding call to addEventListener( ). If no event listener is found that matches the specified arguments, this method does nothing.

Once an event listener function has been removed by this method, it will no longer be invoked for the specified type of event on this node. This is true even if the event listener is removed by another event listener registered for the same type of event on the same node.