---
title: "dispatchEvent(selector, type, eventInit[, options]) | Grafana k6 documentation"
description: "Browser module: frame.dispatchEvent(selector, type, eventInit[, options]) method"
---

# dispatchEvent(selector, type, eventInit\[, options])

> Warning
> 
> Use locator-based [`locator.dispatchEvent(type, eventInit[, options])`](/docs/k6/latest/javascript-api/k6-browser/locator/dispatchevent/) instead.

Dispatches HTML DOM event types e.g. `'click'`.

Expand table

| Parameter       | Type    | Defaults | Description                                                                                                                                                                                                                                                       |
|-----------------|---------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| selector        | string  | `''`     | A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.                                                                                                                                              |
| type            | string  | `''`     | DOM event type e.g. `'click'`.                                                                                                                                                                                                                                    |
| eventInit       | object  | `null`   | Optional event specific properties. See [eventInit](#eventinit) for more details.                                                                                                                                                                                 |
| options         | object  | `null`   |                                                                                                                                                                                                                                                                   |
| options.strict  | boolean | `false`  | When `true`, the call requires selector to resolve to a single element. If given selector resolves to more than one element, the call throws an exception.                                                                                                        |
| options.timeout | number  | `30000`  | Maximum time in milliseconds. Pass `0` to disable the timeout. Default is overridden by the `setDefaultTimeout` option on [BrowserContext](/docs/k6/latest/javascript-api/k6-browser/browsercontext/) or [Page](/docs/k6/latest/javascript-api/k6-browser/page/). |

### eventInit

Since `eventInit` is event-specific, please refer to the events documentation for the lists of initial properties:

- [DragEvent](https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent)
- [FocusEvent](https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent)
- [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent)
- [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent)
- [PointerEvent](https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent)
- [TouchEvent](https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent)
- [Event](https://developer.mozilla.org/en-US/docs/Web/API/Event/Event)

### Returns

Expand table

| Type            | Description                                           |
|-----------------|-------------------------------------------------------|
| `Promise<void>` | A Promise that fulfills when the event is dispatched. |