Page provides methods to interact with a single tab in a running web browser. A single BrowserContext can have many pages.
Method | Description |
---|---|
page.bringToFront() | Activates a browser tab. |
page.check(selector[, options]) | Select the input checkbox. |
page.click(selector[, options]) | Clicks on an element matching a selector. |
page.close() | Closes a tab that the page is associated with. |
page.content() | Gets the HTML contents of the page. |
page.context() | Gets the BrowserContext that the page belongs to. |
page.dblclick(selector[, options]) | With the Mouse, double click on an element matching the provided selector. |
page.dispatchEvent(selector, type, eventInit[, options]) | Dispatches HTML DOM event types e.g. 'click' |
page.$(selector) | Finds an element matching the specified selector within the page. |
page.$$(selector) | Finds all elements matching the specified selector within the page. |
page.emulateMedia([options]) | Changes the CSS media type and the color scheme feature. |
page.emulateVisionDeficiency(type) | Emulates your website with the specified vision deficiency type. |
page.evaluate(pageFunction[, arg]) | Returns the value of the pageFunction invocation. |
page.evaluateHandle(pageFunction[, arg]) | Returns the value of the pageFunction invocation as a JSHandle. |
page.fill(selector, value[, options]) | Fill an input, textarea or contenteditable element with the provided value. |
page.focus(selector[, options]) | Fetches an element with selector and focuses on it. |
page.frames() | Returns an array of frames on the page. |
page.getAttribute(selector, name[, options]) | Returns the element attribute value for the given attribute name. |
page.goto(url[, options]) | Navigates to the specified url. |
page.hover(selector[, options]) | Hovers over an element matching selector. |
page.innerHTML(selector[, options]) | Returns the element.innerHTML. |
page.innerText(selector[, options]) | Returns the element.innerText. |
page.inputValue(selector[, options]) | Returns input.value for the selected input, textarea or select element. |
page.isChecked(selector[, options]) | Checks to see if the checkbox input type is selected or not. |
page.isClosed() | Checks if the page has been closed. |
page.isDisabled(selector[, options]) | Checks if the element is disabled. |
page.isEditable(selector[, options]) | Checks if the element is editable. |
page.isEnabled(selector[, options]) | Checks if the element is enabled. |
page.isHidden(selector[, options]) | Checks if the element is hidden. |
page.isVisible(selector[, options]) | Checks if the element is visible. |
page.keyboard | Returns the Keyboard instance to interact with a virtual keyboard on the page. |
page.locator(selector) | Returns a Locator for the given selector. |
page.mainFrame() | Returns the page's main Frame. |
page.mouse | Returns the Mouse instance to interact with a virtual mouse on the page. |
page.on(event, handler) | Registers a handler to be called whenever the specified event occurs. |
page.opener() | Returns the page that opened the current page. |
page.press(selector, key[, options]) | Focuses the element, and then presses the given key on the Keyboard. |
page.reload([options]) | Reloads the current page. |
page.screenshot([options]) | Returns a buffer with the captured screenshot from the web browser. |
page.selectOption(selector, values[, options]) | Selects one or more options which match the values from a <select> element. |
page.setContent(html[, options]) | Sets the supplied HTML string to the current page. |
page.setDefaultNavigationTimeout(timeout) | Changes the navigation timeout for page.goto(url[, options]), page.reload([options]), page.setContent(html[, options]), and page.waitForNavigation([options]) |
page.setDefaultTimeout(timeout) | Changes the timeout for all the methods accepting a timeout option. |
page.setExtraHTTPHeaders(headers) | Sets extra HTTP headers which will be sent with subsequent HTTP requests. |
page.setViewportSize(viewportSize) | Updates the page's width and height. |
page.tap(selector[, options]) | Taps the first element that matches the selector. |
page.textContent(selector[, options]) | Returns the element.textContent. |
page.title() | Returns the page's title. |
page.type(selector, text[, options]) | Types the text in the first element found that matches the selector. |
page.touchScreen | Returns the Touchscreen instance to interact with a virtual touchscreen on the page. |
page.uncheck(selector[, options]) | Unselects an input checkbox element. |
page.url() | Returns the page's URL. |
page.viewportSize() | Returns the page's size (width and height). |
page.waitForFunction(pageFunction, arg[, options]) | Returns when the pageFunction returns a truthy value. |
page.waitForLoadState(state[, options]) | Waits for the given load state to be reached. |
page.waitForNavigation([options]) | Waits for the given navigation lifecycle event to occur and returns the main resource response. |
page.waitForSelector(selector[, options]) | Returns when element specified by selector satisfies state option. |
page.waitForTimeout(timeout) | Waits for the given timeout in milliseconds. |
page.workers() | Returns an array of the dedicated WebWorkers associated with the page. |