Worker

Worker 类表示一个 WebWorker。worker 事件在页面对象上发出，以指示工作线程的创建。close 事件在工作线程对象上发出，当工作线程消失时。

page.onWorker(worker -> {
  System.out.println("Worker created: " + worker.url());
  worker.onClose(worker1 -> System.out.println("Worker destroyed: " + worker1.url()));
});
System.out.println("Current workers:");
for (Worker worker : page.workers())
  System.out.println("  " + worker.url());

---

方法

evaluate

在 v1.9 之前添加 worker.evaluate

返回 表达式 的返回值。

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

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

用法

Worker.evaluate(expression);
Worker.evaluate(expression, arg);

参数

• expression String#

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

• arg EvaluationArgument (可选)#

  要传递给 表达式 的可选参数。

返回值

• Object#

---

evaluateHandle

在 v1.9 之前添加 worker.evaluateHandle

将 表达式 的返回值作为 JSHandle 返回。

Worker.evaluate() 和 Worker.evaluateHandle() 之间的唯一区别在于 Worker.evaluateHandle() 返回 JSHandle。

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

用法

Worker.evaluateHandle(expression);
Worker.evaluateHandle(expression, arg);

参数

• expression String#

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

• arg EvaluationArgument (可选)#

  要传递给 表达式 的可选参数。

返回值

• JSHandle#

---

url

在 v1.9 之前添加 worker.url

用法

Worker.url();

返回值

• String#

---

waitForClose

在以下版本中添加：v1.10 worker.waitForClose

执行操作并等待工作线程关闭。

用法

Worker.waitForClose(callback);
Worker.waitForClose(callback, options);

参数

• options Worker.WaitForCloseOptions (可选)

  • setTimeout double (可选)在以下版本中添加：v1.9#

    等待的最大时间（以毫秒为单位）。默认值为 30000（30 秒）。传递 0 以禁用超时。可以使用 BrowserContext.setDefaultTimeout() 更改默认值。

• callback Runnable在以下版本中添加：v1.9#

  执行触发事件的操作的回调函数。

返回值

• Worker#

---

事件

onClose(handler)

在 v1.9 之前添加 worker.onClose(handler)

当此专用 WebWorker 被终止时发出。

用法

Worker.onClose(handler)

事件数据

• Worker