Puppeteer 中文文档v25.8.0

Realm.waitForFunction() 方法

等待函数在 realm 的上下文中求值时返回真值。

参数可以从 Node.js 传递给 pageFunction

签名

class Realm {
  waitForFunction<
    Params extends unknown[],
    Func extends EvaluateFunc<Params> = EvaluateFunc<Params>,
  >(
    pageFunction: Func | string,
    options?: {
      polling?: 'raf' | 'mutation' | number;
      timeout?: number;
      root?: ElementHandle<Node>;
      signal?: AbortSignal;
    },
    ...args: Params
  ): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
}

参数

参数

类型

说明

pageFunction

Func | string

要在 realm 中求值的函数。

options

{ polling?: 'raf' | 'mutation' | number; timeout?: number; root?: ElementHandle<Node>; signal?: AbortSignal; }

(可选) 用于轮询和超时的选项。

args

Params

要传递给函数的参数。

返回值:

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

当函数返回真值时解析的 Promise。

示例

const selector = '.foo';
await realm.waitForFunction(
  selector => !!document.querySelector(selector),
  {},
  selector,
);