Version: 1.8.0

Worker

The Worker class represents a WebWorker. worker event is emitted on the page object to signal a worker creation. close event is emitted on the worker object when the worker is gone.

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)

worker.on("close")#

Emitted when this dedicated WebWorker is terminated.

worker.evaluate(expression, **kwargs)#

  • arg <[EvaluationArgument]> Optional argument to pass to page_function
  • expression <str> JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted as a function. Otherwise, evaluated as an expression.
  • force_expr <bool> Whether to treat given expression as JavaScript evaluate expression, even though it looks like an arrow function. Optional.
  • returns: <Serializable>

Returns the return value of page_function

If the function passed to the worker.evaluate returns a Promise, then worker.evaluate would wait for the promise to resolve and return its value.

If the function passed to the worker.evaluate returns a non-Serializable value, then worker.evaluate returns undefined. DevTools Protocol also supports transferring some additional values that are not serializable by JSON: -0, NaN, Infinity, -Infinity, and bigint literals.

worker.evaluate_handle(expression, **kwargs)#

  • arg <[EvaluationArgument]> Optional argument to pass to page_function
  • expression <str> JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, it is interpreted as a function. Otherwise, evaluated as an expression.
  • force_expr <bool> Whether to treat given expression as JavaScript evaluate expression, even though it looks like an arrow function. Optional.
  • returns: <JSHandle>

Returns the return value of page_function as in-page object (JSHandle).

The only difference between worker.evaluate and worker.evaluateHandle is that worker.evaluateHandle returns in-page object (JSHandle).

If the function passed to the worker.evaluateHandle returns a Promise, then worker.evaluateHandle would wait for the promise to resolve and return its value.

worker.url#