Menu
Open source
Page
Page provides methods to interact with a single tab in a running web browser. A single
BrowserContext can have many pages.
| Method | Description |
|---|---|
| $(selector) | Finds an element matching the specified selector within the page. |
| $$(selector) | Finds all elements matching the specified selector within the page. |
| bringToFront() | Activates a browser tab. |
| check(selector[, options]) | Select the input checkbox. |
| click(selector[, options]) | Clicks on an element matching a selector. |
| close() | Closes a tab that the page is associated with. |
| content() | Gets the HTML contents of the page. |
| context() | Gets the BrowserContext that the page belongs to. |
| dblclick(selector[, options]) | With the
Mouse, double click on an element matching the provided selector. |
| dispatchEvent(selector, type, eventInit[, options]) | Dispatches HTML DOM event types e.g. 'click' |
| 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. |
| getByAltText(altText[, options]) | Returns a locator for elements with the specified alt attribute text. |
| getByLabel(text[, options]) | Returns a locator for form controls with the specified label text. |
| getByPlaceholder(placeholder[, options]) | Returns a locator for input elements with the specified placeholder attribute text. |
| getByRole(role[, options]) | Returns a locator for elements with the specified ARIA role. |
| getByTestId(testId) | Returns a locator for elements with the specified data-testid attribute. |
| getByText(text[, options]) | Returns a locator for elements containing the specified text. |
| getByTitle(title[, options]) | Returns a locator for elements with the specified title attribute. |
| 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 checkbox input 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[, options]) | 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. |
| route(url, handler) | Adds a route to the page to modify network requests made by that 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. |
| waitForResponse(urlPattern[, options]) | Waits for an HTTP response that matches the specified URL pattern. |
| waitForSelector(selector[, options]) | Returns when element specified by selector satisfies state option. |
| waitForTimeout(timeout) | Waits for the given timeout in milliseconds. |
| waitForURL(url[, options]) | Waits for the page to navigate to the specified URL. |
| workers() | Returns an array of the dedicated WebWorkers associated with the page. |
Was this page helpful?
Related resources from Grafana Labs
Video
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.
Events
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.