puppeteer/website/versioned_docs/version-22.8.1/api/puppeteer.eventemitter.on.md

67 lines
854 B
Markdown
Raw Normal View History

---
sidebar_label: EventEmitter.on
---
# EventEmitter.on() method
Bind an event listener to fire when an event occurs.
#### Signature:
```typescript
class EventEmitter {
on<Key extends keyof EventsWithWildcard<Events>>(
type: Key,
handler: Handler<EventsWithWildcard<Events>[Key]>
): this;
}
```
## Parameters
<table><thead><tr><th>
Parameter
</th><th>
Type
</th><th>
Description
</th></tr></thead>
<tbody><tr><td>
type
</td><td>
Key
</td><td>
the event type you'd like to listen to. Can be a string or symbol.
</td></tr>
<tr><td>
handler
</td><td>
[Handler](./puppeteer.handler.md)&lt;[EventsWithWildcard](./puppeteer.eventswithwildcard.md)&lt;Events&gt;\[Key\]&gt;
</td><td>
the function to be called when the event occurs.
</td></tr>
</tbody></table>
**Returns:**
this
`this` to enable you to chain method calls.