Skip to main content
Version: 17.1.0

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

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