puppeteer/website/versioned_docs/version-17.1.3/api/puppeteer.eventemitter.md
release-please[bot] 9b120f6c7b
chore(main): release 17.1.3 (#8921)
* chore(main): release 17.1.3

* chore: generate versioned docs

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-09-08 13:16:39 +00:00

2.6 KiB

sidebar_label
EventEmitter

EventEmitter class

The EventEmitter class that many Puppeteer classes extend.

Signature:

export declare class EventEmitter implements CommonEventEmitter

Implements: CommonEventEmitter

Remarks

This allows you to listen to events that Puppeteer classes fire and act accordingly. Therefore you'll mostly use on and off to bind and unbind to event listeners.

The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the EventEmitter class.

Methods

Method Modifiers Description
addListener(event, handler) Add an event listener.
emit(event, eventData) Emit an event and call any associated listeners.
listenerCount(event) Gets the number of listeners for a given event.
off(event, handler) Remove an event listener from firing.
on(event, handler) Bind an event listener to fire when an event occurs.
once(event, handler) Like on but the listener will only be fired once and then it will be removed.
removeAllListeners(event) Removes all listeners. If given an event argument, it will remove only listeners for that event.
removeListener(event, handler) Remove an event listener.