Skip to main content
Version: 17.1.3

Frame.waitForSelector() method

Waits for an element matching the given selector to appear in the frame.

This method works across navigations.

Signature:

class Frame {
waitForSelector<Selector extends string>(
selector: Selector,
options?: WaitForSelectorOptions
): Promise<ElementHandle<NodeFor<Selector>> | null>;
}

Parameters

ParameterTypeDescription
selectorSelectorThe selector to query and wait for.
optionsWaitForSelectorOptions(Optional) Options for customizing waiting behavior.

Returns:

Promise<ElementHandle<NodeFor<Selector>> | null>

An element matching the given selector.

Exceptions

Throws if an element matching the given selector doesn't appear.

Example

const puppeteer = require('puppeteer');

(async () => {
const browser = await puppeteer.launch();
const page = await browser.newPage();
let currentURL;
page
.mainFrame()
.waitForSelector('img')
.then(() => console.log('First URL with image: ' + currentURL));

for (currentURL of [
'https://example.com',
'https://google.com',
'https://bbc.com',
]) {
await page.goto(currentURL);
}
await browser.close();
})();