Puppeteer 中文文档v25.8.0

Realm 类

签名

export declare abstract class Realm

备注

此类的构造函数被标记为内部方法。第三方代码不应直接调用构造函数,也不应创建继承 Realm 类的子类。

属性

属性

修饰符

类型

说明

origin

readonly

string | undefined

(实验性) 返回创建该 Realm 的 origin。例如,如果该 realm 是由扩展内容脚本创建的,则此方法返回该扩展的 origin(例如 chrome-extension://<extension-id>)。

方法

方法

修饰符

说明

[disposeSymbol]()

evaluate(pageFunction, args)

在 realm 的上下文中求值一个函数,并返回结果值。

如果传递给 realm.evaluate 的函数返回 Promise,该方法将等待 Promise 解析并返回其值。

JSHandle 实例可以作为参数传递给该函数。

evaluateHandle(pageFunction, args)

在 realm 的上下文中求值一个函数,并返回指向结果的 JSHandle

如果传递给 realm.evaluateHandle 的函数返回 Promise,该方法将等待 Promise 解析并返回其值。

JSHandle 实例可以作为参数传递给该函数。

extension()

(实验性) 如果适用,返回创建此 realm 的 Extension。当 realm 是由注入到页面中的扩展内容脚本创建时,通常会填充此属性。

waitForFunction(pageFunction, options, args)

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

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