跳转到主要内容

Worker

Worker 类代表一个 WebWorker。当创建一个 worker 时，页面对象会发出 worker 事件。当 worker 消失时，worker 对象会发出 close 事件。

def handle_worker(worker):
    print("worker created: " + worker.url)
    worker.on("close", lambda: print("worker destroyed: " + worker.url))

page.on('worker', handle_worker)

print("current workers:")
for worker in page.workers:
    print("    " + worker.url)

方法​

evaluate​

v1.9 之前添加 worker.evaluate

返回 expression 的返回值。

如果传递给 worker.evaluate() 的函数返回一个 Promise，那么 worker.evaluate() 将等待该 promise 解析并返回其值。

如果传递给 worker.evaluate() 的函数返回一个非可序列化的值，那么 worker.evaluate() 返回 undefined。Playwright 还支持传输一些 JSON 无法序列化的额外值：-0、NaN、Infinity、-Infinity。

用法

worker.evaluate(expression)
worker.evaluate(expression, **kwargs)

参数

  • expression str#

    要在浏览器上下文中计算的 JavaScript 表达式。如果表达式计算为函数，则该函数会自动调用。

  • arg EvaluationArgument (可选)#

    要传递给 expression 的可选参数。

返回

evaluate_handle​

v1.9 之前添加 worker.evaluate_handle

将 expression 的返回值作为 JSHandle 返回。

worker.evaluate() 和 worker.evaluate_handle() 之间的唯一区别是 worker.evaluate_handle() 返回 JSHandle。

如果传递给 worker.evaluate_handle() 的函数返回一个 Promise，那么 worker.evaluate_handle() 将等待该 promise 解析并返回其值。

用法

worker.evaluate_handle(expression)
worker.evaluate_handle(expression, **kwargs)

参数

  • expression str#

    要在浏览器上下文中计算的 JavaScript 表达式。如果表达式计算为函数，则该函数会自动调用。

  • arg EvaluationArgument (可选)#

    要传递给 expression 的可选参数。

返回

expect_event​

Added in: v1.57 worker.expect_event

等待事件触发并将值传递给谓词函数。在谓词返回真值时返回。如果事件在页面关闭前触发，将抛出错误。返回事件数据值。

用法

with worker.expect_event("console") as event_info:
    worker.evaluate("console.log(42)")
message = event_info.value

参数

  • event str#

    事件名称，通常传递给 *.on(event) 的相同名称。

  • predicate Callable (可选)#

    接收事件数据，并在等待应该解决时解析为真值。

  • timeout float (可选)#

    最大等待时间（以毫秒为单位）。默认为 30000（30秒）。传入 0 可禁用超时。默认值可以通过使用 browser_context.set_default_timeout() 更改。

返回

属性​

url​

v1.9 之前添加 worker.url

用法

worker.url

返回

事件​

on("close")​

v1.9 之前添加 worker.on("close")

当此专用 WebWorker 终止时发出。

用法

worker.on("close", handler)

事件数据

on("console")​

Added in: v1.57 worker.on("console")

当 worker 中的 JavaScript 调用其中一个控制台 API 方法（例如 console.log 或 console.dir）时触发。

用法

worker.on("console", handler)

事件数据