Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

x/pptr/src/Page.ts>Page#$$eval

Headless Chrome Deno API
Latest
method Page.prototype.$$eval
import { Page } from "https://deno.land/x/pptr@1.2.0/src/Page.ts";

This method runs Array.from(document.querySelectorAll(selector)) within the page and passes the result as the first argument to the pageFunction.

Examples

Example 1

// get the amount of divs on the page
const divCount = await page.$$eval('div', divs => divs.length);

// get the text content of all the `.options` elements:
const options = await page.$$eval('div > span.options', options => {
  return options.map(option => option.textContent)
});

If you are using TypeScript, you may have to provide an explicit type to the first argument of the pageFunction. By default it is typed as Element[], but you may need to provide a more specific sub-type:

Example 2

// if you don't provide HTMLInputElement here, TS will error
// as `value` is not on `Element`
await page.$$eval('input', (elements: HTMLInputElement[]) => {
  return elements.map(e => e.value);
});

The compiler should be able to infer the return type from the pageFunction you provide. If it is unable to, you can use the generic type to tell the compiler what return type you expect from $$eval:

Example 3

// The compiler can infer the return type in this case, but if it can't
// or if you want to be more explicit, provide it as the generic type.
const allInputValues = await page.$$eval<string[]>(
 'input', (elements: HTMLInputElement[]) => elements.map(e => e.textContent)
);

Type Parameters

ReturnType

Parameters

selector: string

the selector to query for

pageFunction: (elements: Element[], ...args: unknown[]) => ReturnType | Promise<ReturnType>

the function to be evaluated in the page context. Will be passed the result of Array.from(document.querySelectorAll(selector)) as its first argument.

any additional arguments to pass through to pageFunction.

Returns

The result of calling pageFunction. If it returns an element it is wrapped in an ElementHandle, else the raw value itself is returned.