ElementHandle.waitForSelector() メソッド

指定されたセレクターに一致する要素が現在の要素内に現れるのを待ちます。

Frame.waitForSelector()とは異なり、このメソッドはナビゲーションをまたいで動作したり、要素がDOMから切り離されたりした場合には動作しません。

シグネチャ:

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

パラメータ

パラメータ	型	説明
selector	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();
})();