跳至主要内容

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());

方法

评估

Added before v1.9 worker.evaluate

返回expression的返回值。

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

如果传递给Worker.evaluate()的函数返回一个非Serializable的值,那么Worker.evaluate()会返回undefined。Playwright还支持传输一些无法被JSON序列化的额外值:-0NaNInfinity-Infinity

用法

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

参数

  • expression String#

    要在浏览器上下文中评估的JavaScript表达式。如果表达式评估为一个函数,该函数将自动被调用。

  • arg EvaluationArgument (可选)#

    可选的参数传递给 expression

返回


evaluateHandle

Added before 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

返回


网址

Added before v1.9 worker.url

用法

Worker.url();

返回


waitForClose

Added in: v1.10 worker.waitForClose

执行操作并等待Worker关闭。

用法

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

参数

  • options Worker.WaitForCloseOptions (可选)

    • setTimeout double (可选参数) 添加于: v1.9#

      最大等待时间,单位为毫秒。默认为30000(30秒)。传入0可禁用超时。默认值可以通过BrowserContext.setDefaultTimeout()来修改。

  • callback Runnable 添加于: v1.9#

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

返回


事件

onClose(handler)

Added before v1.9 worker.onClose(handler)

当这个专用的WebWorker被终止时触发。

用法

Worker.onClose(handler)

事件数据