Skip to main content
Page evaluation methods for the Puppeteer driver.

​
evaluate

Evaluate JavaScript in the page context. Upstream docs
​
pageFunction
string
required
​
args
unknown[]
​
result
unknown
Return value
await page.evaluate('...');

​
$eval

Evaluate JavaScript on a selected element. Upstream docs
​
selector
string
required
​
pageFunction
string
required
​
args
unknown[]
​
result
unknown
Return value
await page.$eval('...', '...');

​
$$eval

Evaluate JavaScript on all matching elements. Upstream docs
​
selector
string
required
​
pageFunction
string
required
​
args
unknown[]
​
result
unknown
Return value
await page.$$eval('...', '...');

​
evaluateHandle

Evaluate handle (returns a JSHandle).
Note: Handles are not fully supported in RPC mode - use evaluate instead.
Upstream docs
​
pageFunction
string
required
​
args
unknown[]
​
result
unknown
Return value
await page.evaluateHandle('...');

​
evaluateOnNewDocument

Add a script to evaluate when a new document is created. Upstream docs
​
pageFunction
string
required
​
args
unknown[]
​
result
{ identifier: string }
Return value
await page.evaluateOnNewDocument('...');