ElementHandle.waitForSelector() 方法
¥ElementHandle.waitForSelector() method
等待与给定选择器匹配的元素出现在当前元素中。
¥Wait for an element matching the given selector to appear in the current element.
与 Frame.waitForSelector() 不同,此方法不适用于跨导航或元素与 DOM 分离的情况。
¥Unlike Frame.waitForSelector(), this method does not work across navigations or if the element is detached from DOM.
签名
¥Signature
class ElementHandle {
waitForSelector<Selector extends string>(
selector: Selector,
options?: WaitForSelectorOptions
): Promise<ElementHandle<NodeFor<Selector>> | null>;
}
参数
¥Parameters
范围 | 类型 | 描述 |
---|---|---|
selector | 选择器 | 要查询和等待的选择器。 |
options | (可选的)用于自定义等待行为的选项。 |
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
import puppeteer from '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();
})();