Page API

The Page object combines native CDP transport methods with high-level Lua helpers.

Native Methods

`page:call(method, params)`

async

Raw page-level CDP command.

`page:call_save(method, params, path)`

async

Optimized binary call. Saves the data field of the response to path and returns the JSON without the massive data string. Supports .png, .jpg, .pdf, .zip, etc.

`page:wait_event(event, ...)`

async

Wait for a page-level CDP notification. Accepts variadic args: timeout (number), predicate (function), or a table with timeout_ms/timeout and predicate.

`page:close()`

sync

Closes the specific tab.

`page:open(url, [wait_until], [timeout_ms])`

async

Returns true or nil, error.

local ok, err = page:open("https://example.com")
if not ok then
    log("Navigation failed: " .. tostring(err))
end

`page:wait_for_selector(selector, [opts])`

async

Returns true, element_info or nil, error. opts can be timeout (number) or {timeout, poll_ms, visible, scroll}.

local found = page:wait_for_selector(".content", 10000)
if found then
    local html = page:content()
end

`page:wait_for_idle([timeout_ms], [quiet_ms])`

async

Wait for network idle.

`page:wait_for_url(pattern, timeout_ms)`

async

Polls location.href until it matches the string pattern. Returns the URL or nil, error.

Evaluation

`page:evaluate(js)`

async

Returns the result of the JavaScript expression.

local title = page:evaluate("document.title")
local count = page:evaluate("document.querySelectorAll('.item').length")

`page:content()`

async

Returns the full rendered HTML.

local html = page:content()

`page:screenshot(path, [opts])`

async

Saves a screenshot. Subject to 10MB response limit.

Option	Type	Default	Description
`format`	string	`"png"`	`"png"` or `"jpeg"`
`quality`	number	-	1-100 (jpeg only)
`full_page`	boolean	`false`	Capture full page
`fromSurface`	boolean	-	Capture from surface

page:screenshot("page.png")
page:screenshot("page.jpg", { format = "jpeg", quality = 80, full_page = true })

Interaction

`page:click(selector, [opts])`

async

Click an element. opts.real = true uses hardware mouse events.

page:click("button.submit")
page:click("button.submit", { real = true })

`page:type(selector, text, [opts])`

async

Type text into an element. opts.real = true uses hardware keyboard events.

page:type("input.search", "hello world")

`page:scroll([opts])`

async

Scrolls the page.

Option	Type	Default	Description
`max_scrolls`	number	20	Maximum scroll attempts
`step`	number	-	Pixels to scroll per step
`delay_ms`	number	250	Delay between scrolls
`until_selector`	string	-	Scroll until selector appears
`until_bottom`	boolean	`true`	Scroll until page bottom

page:scroll({ until_selector = ".footer" })

`page:set_extra_headers(headers)`

async

Sets extra HTTP headers via Network.setExtraHTTPHeaders.

`page:set_user_agent(user_agent, [opts])`

async

Overrides the User-Agent. opts can include accept_language and platform.

Network

`page:block_resources(types)`

async

Block resource types.

page:block_resources({"image", "font", "media"})

`page:wait_for_response([predicate], [timeout_ms])`

async

Waits for Network.responseReceived. Optional predicate function receives params, returns true when match found.

`page:cookies([urls])`

async

Returns all cookies, or filtered by URL if urls is provided.

`page:set_cookies(cookies)`

async

Sets cookies via Network.setCookies.