Frame.waitForFunction() 方法

簽名

class Frame {
  waitForFunction<
    Params extends unknown[],
    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
  >(
    pageFunction: Func | string,
    options?: FrameWaitForFunctionOptions,
    ...args: Params
  ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
}

參數

參數	類型	描述
pageFunction	函式 | 字串	要在框架內容中評估的函式。
options	FrameWaitForFunctionOptions	（可選）用於配置輪詢方法和逾時的選項。
args	Params	傳遞給 pageFunction 的引數。

回傳

Promise<HandleFor<Awaited<ReturnType<Func>>>>

當 pageFunction 回傳真值時，Promise 會被解析。

範例

waitForFunction 可用於觀察視口大小變更

import puppeteer from 'puppeteer';

(async () => {
.  const browser = await puppeteer.launch();
.  const page = await browser.newPage();
.  const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100');
.  page.setViewport({width: 50, height: 50});
.  await watchDog;
.  await browser.close();
})();

將引數從 Node.js 傳遞到 page.waitForFunction 函式的述詞

const selector = '.foo';
await frame.waitForFunction(
  selector => !!document.querySelector(selector),
  {}, // empty options object
  selector,
);