puppeteer/website/versioned_docs/version-21.7.0/api/puppeteer.eventemitter.md
release-please[bot] 864012a86d
chore: release main (#11593)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2024-01-04 13:39:46 +00:00

2.7 KiB

sidebar_label
EventEmitter

EventEmitter class

The EventEmitter class that many Puppeteer classes extend.

Signature:

export declare class EventEmitter<Events extends Record<EventType, unknown>> implements CommonEventEmitter<EventsWithWildcard<Events>>

Implements: CommonEventEmitter<EventsWithWildcard<Events>>

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(type, handler) Add an event listener.
emit(type, event) Emit an event and call any associated listeners.
listenerCount(type) Gets the number of listeners for a given event.
off(type, handler) Remove an event listener from firing.
on(type, handler) Bind an event listener to fire when an event occurs.
once(type, handler) Like on but the listener will only be fired once and then it will be removed.
removeAllListeners(type) Removes all listeners. If given an event argument, it will remove only listeners for that event.
removeListener(type, handler) Remove an event listener.