setChecked(checked[, options])

警告
请使用 locator.setChecked(checked [, options]) 代替。

使用此方法选择或取消选择输入框或单选框。

参数	类型	默认值	描述
options	object	`null`	可选参数。
options.force	boolean	`false`	将其设置为 `true` 将绕过可操作性检查（可见、稳定、启用）。
options.noWaitAfter	boolean	`false`	如果设置为 `true` 并且执行此操作后发生导航，脚本将不会等待其完成。
options.position	object	`null`	相对于元素左上角的点。如果未提供，则使用元素的可见点。
options.position.x	number	`0`	x 坐标。
options.position.y	number	`0`	y 坐标。
options.timeout	number	`30000`	最大超时时间（毫秒）。传递 `0` 可禁用超时。默认值会被 BrowserContext 或 Page 上的 `setDefaultTimeout` 选项覆盖。
options.trial	boolean	`false`	将其设置为 `true` 将执行可操作性检查，但不会实际执行操作。

返回值

类型	描述
`Promise<void>`	检查操作完成时解析的 Promise。

示例

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 checkbox = await page.$('#checkbox1');
  await checkbox.setChecked(true);
  await checkbox.setChecked(false);

  await page.close();
}