Worker

Worker 类代表一个 WebWorker。当创建一个 worker 时，页面对象会发出 worker 事件。当 worker 消失时，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

返回 expression 的返回值。

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

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

用法

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

参数

• expression String#

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

• arg EvaluationArgument (可选)#

  传递给 expression 的可选参数。

返回

• Object#

---

evaluateHandle

v1.9 之前添加 worker.evaluateHandle

返回 expression 的返回值，作为 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 (可选)#

  传递给 expression 的可选参数。

返回

• JSHandle#

---

url

v1.9 之前添加 worker.url

用法

Worker.url();

返回

• String#

---

waitForClose

新增于: v1.10 worker.waitForClose

执行操作并等待 Worker 关闭。

用法

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

参数

• options Worker.WaitForCloseOptions (可选)

  • setTimeout 双精度浮点数 (可选)添加于：v1.9#

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

• callback Runnable添加于：v1.9#

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

返回

• Worker#

---

waitForConsoleMessage

Added in: v1.57 worker.waitForConsoleMessage

执行操作并等待一条控制台消息。

用法

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

参数

• options Worker.WaitForConsoleMessageOptions (可选)

  • setPredicate Predicate<ConsoleMessage> (可选)#

    接收 ConsoleMessage 对象，并在等待应解析时解析为 true。

  • setTimeout double (可选)#

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

• callback Runnable#

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

返回

• ConsoleMessage#

---

事件

onClose(handler)

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

当此专用 WebWorker 终止时发出。

用法

Worker.onClose(handler)

事件数据

• Worker

---

onConsole(handler)

Added in: v1.57 worker.onConsole(handler)

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

用法

Worker.onConsole(handler)

事件数据

• ConsoleMessage