class:jshandle

class: JSHandle v0.9.0

JSHandle 表示页面内的 JavaScript 对象。 JSHandles 可以使用 page.evaluateHandle 方法创建。

const windowHandle = await page.evaluateHandle(() => window);// ...

JSHandle 可防止引用的 JavaScript 对象被垃圾收集，除非是句柄 disposed。 当原始框架被导航或父上下文被破坏时，JSHandles 会自动处理。 JSHandle 实例可以使用在 page.$eval()，page.evaluate() 和 page.evaluateHandle 方法。

Methods

• jsHandle.asElement()v0.9.0
• jsHandle.dispose()v0.9.0
• jsHandle.executionContext()v0.9.0
• jsHandle.getProperties()v0.9.0
• jsHandle.getProperty(propertyName)v0.9.0
• jsHandle.jsonValue()v0.9.0

Methods

jsHandle.asElement()v0.9.0

• returns: <?ElementHandle> 如果对象句柄是 ElementHandle 的一个实例，则返回 null 或对象句柄本身。

jsHandle.dispose()v0.9.0

• returns: <Promise> Promise which resolves when the object handle is successfully disposed. jsHandle.dispose 方法停止引用元素句柄。

jsHandle.executionContext()v0.9.0

• returns: ExecutionContext 返回句柄所属的执行上下文。

jsHandle.getProperties()v0.9.0

• returns: <Promise<Map<string, JSHandle>>> 该方法返回一个包含属性名称作为键的映射和属性值的 JSHandle 实例。

返回对象的 JSON 表示。如果对象又一个 toJSON 函数, 它 将不会被调用。

注意 如果引用的对象不可字符串化，该方法将返回一个空的 JSON 对象。 如果对象具有循环引用，它将引发一个错误。