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

sidebar_label

sidebar_label
Frame.click

Frame.click() method

Clicks the first element found that matches selector.

Signature

class Frame {
  click(selector: string, options?: Readonly<ClickOptions>): Promise<void>;
}

Parameters

Parameter	Type	Description
selector	string	The selector to query for.
options	Readonly<ClickOptions>	(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),
]);