puppeteer/website/versioned_docs/version-17.0.0/api/puppeteer.frame.click.md

sidebar_label
Frame.click

Frame.click() method

Clicks the first element found that matches selector.

Signature:

class Frame {
  click(
    selector: string,
    options?: {
      delay?: number;
      button?: MouseButton;
      clickCount?: number;
    }
  ): Promise<void>;
}

Parameters

Parameter	Type	Description
selector	string	The selector to query for.
options	{ delay?: number; button?: MouseButton; clickCount?: number; }	(Optional)

Returns:

Promise<void>

Remarks

If click() triggers a navigation event and there's a separate page.waitForNavigation() promise to be resolved, you may end up with a race condition that yields unexpected results. The correct pattern for click and wait for navigation is the following:

const [response] = await Promise.all([
  page.waitForNavigation(waitOptions),
  frame.click(selector, clickOptions),
]);