---
title: "dispatchEvent(type, eventInit) | Grafana k6 documentation"
description: "Browser module: elementHandle.dispatchEvent method"
---

# dispatchEvent(type, eventInit)

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

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

Expand table

| Parameter       | Type   | Defaults | Description                                                                                                                                                                                                                                                   |
|-----------------|--------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 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.timeout | number | `30000`  | Maximum time in milliseconds. Pass `0` to disable the timeout. Default is overridden by the `setDefaultTimeout` option on [BrowserContext](/docs/k6/next/javascript-api/k6-browser/browsercontext/) or [Page](/docs/k6/next/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 once the event is dispatched. |

### Example

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
import { browser } from 'k6/browser';

export const options = {
  scenarios: {
    browser: {
      executor: 'shared-iterations',
      options: {
        browser: {
          type: 'chromium',
        },
      },
    },
  },
};

export default async function () {
  const page = await browser.newPage();
  await page.goto('https://test.k6.io/browser.php');

  const button = await page.$('#counter-button');
  await button.dispatchEvent('click');

  await page.close();
}
```