Finds an element matching the specified selector within the page.
page$$(selector)
Finds all elements matching the specified selector within the page.
emulateMedia([options])
Changes the CSS media type and the color scheme feature.
emulateVisionDeficiency(type)
Emulates your website with the specified vision deficiency type.
evaluate(pageFunction[, arg])
Returns the value of the pageFunction invocation.
evaluateHandle(pageFunction[, arg])
Returns the value of the pageFunction invocation as a
JSHandle.
fill(selector, value[, options])
Fill an input, textarea or contenteditable element with the provided value.
focus(selector[, options])
Fetches an element with selector and focuses on it.
frames()
Returns an array of frames on the page.
getAttribute(selector, name[, options])
Returns the element attribute value for the given attribute name.
goto(url[, options])
Navigates to the specified url.
hover(selector[, options])
Hovers over an element matching selector.
innerHTML(selector[, options])
Returns the element.innerHTML.
innerText(selector[, options])
Returns the element.innerText.
inputValue(selector[, options])
Returns input.value for the selected input, textarea or select element.
isChecked(selector[, options])
Checks to see if the checkboxinput type is selected or not.
isClosed()
Checks if the page has been closed.
isDisabled(selector[, options])
Checks if the element is disabled.
isEditable(selector[, options])
Checks if the element is editable.
isEnabled(selector[, options])
Checks if the element is enabled.
isHidden(selector[, options])
Checks if the element is hidden.
isVisible(selector[, options])
Checks if the element is visible.
keyboard
Returns the
Keyboard instance to interact with a virtual keyboard on the page.
locator(selector)
Returns a
Locator for the given selector.
mainFrame()
Returns the page’s main
Frame.
mouse
Returns the
Mouse instance to interact with a virtual mouse on the page.
on(event, handler)
Registers a handler to be called whenever the specified event occurs.
opener()
Returns the page that opened the current page.
press(selector, key[, options])
Focuses the element, and then presses the given key on the
Keyboard.
reload([options])
Reloads the current page.
screenshot([options])
Returns a buffer with the captured screenshot from the web browser.
selectOption(selector, values[, options])
Selects one or more options which match the values from a <select> element.
setContent(html[, options])
Sets the supplied HTML string to the current page.
setChecked(selector, checked[, options])
Sets the checkbox or radio input element’s value to the specified checked or unchecked state.
setDefaultNavigationTimeout(timeout)
Changes the navigation timeout for
page.goto(url[, options]),
page.reload([options]),
page.setContent(html[, options]), and
page.waitForNavigation([options])
setDefaultTimeout(timeout)
Changes the timeout for all the methods accepting a timeout option.
setExtraHTTPHeaders(headers)
Sets extra HTTP headers which will be sent with subsequent HTTP requests.
setInputFiles(selector, file[, options])
Sets the file input element’s value to the specified files.
setViewportSize(viewportSize)
Updates the page’s width and height.
tap(selector[, options])
Taps the first element that matches the selector.
textContent(selector[, options])
Returns the element.textContent.
throttleCPU(cpuProfile)
Throttles the CPU in Chrome/Chromium to slow it down by the specified rate in the cpuProfile object.
throttleNetwork(networkProfile)
Throttles the network in Chrome/Chromium to slow it down by the specified fields in the networkProfile object.
title()
Returns the page’s title.
type(selector, text[, options])
Types the text in the first element found that matches the selector.
touchscreen
Returns the
Touchscreen instance to interact with a virtual touchscreen on the page.
uncheck(selector[, options])
Unselects an input checkbox element.
url()
Returns the page’s URL.
viewportSize()
Returns the page’s size (width and height).
waitForFunction(pageFunction, arg[, options])
Returns when the pageFunction returns a truthy value.
waitForLoadState(state[, options])
Waits for the given load state to be reached.
waitForNavigation([options])
Waits for the given navigation lifecycle event to occur and returns the main resource response.
waitForSelector(selector[, options])
Returns when element specified by selector satisfies state option.
waitForTimeout(timeout)
Waits for the given timeout in milliseconds.
workers()
Returns an array of the dedicated
WebWorkers associated with the page.
Additional helpful documentation, links, and articles:
60 min
Performance testing and observability in Grafana Cloud
Optimize user experiences with Grafana Cloud. Learn real-time insights, performance testing with k6, and continuous validation with Synthetic Monitoring.
60 min
User-centered observability: load testing, real user monitoring, and synthetics
Learn how to use load testing, synthetic monitoring, and real user monitoring (RUM) to understand end users' experience of your apps. Watch on demand.
