菜单
文档breadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/browserbreadcrumb arrow Pagebreadcrumb arrow dispatchEvent(selector, type, eventInit[, options])
开源

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

警告

请改用基于 Locator 的 locator.dispatchEvent(type, eventInit[, options])

分发 HTML DOM 事件类型,例如 'click'

参数类型默认值描述
selectorstring''用于搜索元素的 Selector。如果多个元素满足 Selector,将使用第一个元素。
typestring''DOM 事件类型,例如 'click'
eventInitobjectnull可选的事件特定属性。详见 eventInit 了解更多。
optionsobjectnull
options.strictbooleanfalsetrue 为 true 时,要求 Selector 解析为单个元素。如果给定的 Selector 解析到多个元素,调用将抛出异常。
options.timeoutnumber30000最大超时时间(毫秒)。传入 0 可禁用超时。默认值会被 BrowserContextPage 上的 setDefaultTimeout 选项覆盖。

eventInit

由于 eventInit 是事件特定的,请参考事件文档了解初始属性列表

返回值

类型描述
Promise<void>事件分发完成时兑现的 Promise。

示例

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');
  await page.dispatchEvent('#counter-button', 'click');
}