Skip to main content
Version: Next

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),
]);