ElementHandle.waitForSelector() 方法

等待符合指定選擇器的元素出現在目前元素中。

與 Frame.waitForSelector() 不同，此方法不適用於跨導航或元素從 DOM 分離的情況。

簽名

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

參數

參數	類型	描述
selector	選擇器	要查詢並等待的選擇器。
options	WaitForSelectorOptions	（選填）用於自訂等待行為的選項。

返回

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

符合指定選擇器的元素。

例外

如果符合指定選擇器的元素沒有出現，則拋出例外。

範例

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();
})();