addEventListener

abstract fun addEventListener(type: String, listener: EventListener)

Adds a new handler for the type event. Any given listener is added only once per type and per capture option value.

If the once option is true, the listener is removed after the next time a type event is dispatched.

The capture option is not used by Node.js in any functional way other than tracking registered event listeners per the EventTarget specification. Specifically, the capture option is used as part of the key when registering a listener. Any individual listener may be added once with capture = false, and once with capture = true.

Parameters

type

The name of the event.

listener

The callback function.


abstract fun addEventListener(type: String, listener: Value, options: Value?)
abstract fun addEventListener(type: String, options: AddEventListenerOptions, listener: EventListener)

Adds a new handler for the type event. Any given listener is added only once per type and per capture option value.

If the once option is true, the listener is removed after the next time a type event is dispatched.

The capture option is not used by Node.js in any functional way other than tracking registered event listeners per the EventTarget specification. Specifically, the capture option is used as part of the key when registering a listener. Any individual listener may be added once with capture = false, and once with capture = true.

Parameters

type

The name of the event.

listener

The callback function.

options

An option object that specifies characteristics about the event listener.