Playwright Frame

Navigates the frame to the given URL. In case of multiple redirects, the navigation will resolve with the first non-redirect response. The method will throw an error if navigation fails. The method will not throw an error when any valid HTTP status code is returned by the remote server.

This method can be used after an action that causes navigation. A glob pattern, regex pattern or predicate receiving URL to match while waiting for the navigation.

This method returns when the page reaches a required load state, ‘load’ by default. The navigation must have been committed when this method is called.

This method takes the HTML to set as the frame’s content. The default waitUntil is ‘load’.

This method waits for actionability checks, scrolls element into view, and then clicks the center of the element. Discouraged: use locator-based locator.click() instead.

This method waits for actionability checks, scrolls element into view, and then double-clicks the center of the element. Discouraged: use locator-based locator.dblclick() instead.

This method waits for an element matching selector, waits for actionability checks, focuses the element, fills it and triggers an input event. Discouraged: use locator-based locator.fill() instead.

Sends a keydown, keypress/input, and keyup event for each character in the text. Discouraged: In most cases, you should use locator.fill() instead.

Focuses the element matching selector, and then uses keyboard.press. Discouraged: use locator-based locator.press() instead.

This method waits for actionability checks, scrolls element into view, and then hovers over the center of the element. Discouraged: use locator-based locator.hover() instead.

If there is no element matching selector, the method waits until a matching element appears in the DOM. Discouraged: use locator-based locator.focus() instead.

This method waits for actionability checks, scrolls element into view, and then taps the center of the element. Discouraged: use locator-based locator.tap() instead.

This method checks an element matching selector by performing the following steps: scrolls element into view, and then uses click to check the element. Discouraged: use locator-based locator.check() instead.

This method unchecks an element matching selector by scrolling element into view and using click to uncheck the element. Discouraged: use locator-based locator.uncheck() instead.

This method checks or unchecks an element matching selector. Discouraged: use locator-based locator.setChecked() instead.

Returns array of selected option values. Shortcuts such as “blue” match both value and label. Objects such as { label: “blue” } match by label only. Discouraged: use locator-based locator.selectOption() instead.

Empty array clears the selected files. Discouraged: use locator-based locator.setInputFiles() instead.

This method drags the source element to the target element. It will first move to the source element, perform a mousedown, then move to the target element and perform a mouseup.

This method dispatches a DOM event on the element matching selector. Events are composed, cancelable, and bubble by default. Discouraged: use locator-based locator.dispatchEvent() instead.

Returns the cached page reference passed at construction time.

The locator is a building block for accessing and interacting with elements on the page. Locators are strict by default - they will throw if more than one element matches the selector.

Use this when the <iframe> is lazy loaded. Use has and hasText options to locate elements inside a frame based on their content.

Matching by text always normalizes whitespace, even with exact match. For example, it turns multiple spaces into one, turns line breaks into spaces and ignores leading and trailing whitespace.

This method allows locating elements by their alt text. It works with <img> and <area> elements.

By default, the data-testid attribute is used as a test id. Use selectors.setTestIdAttribute() to configure a different test id attribute if necessary.

This method queries the frame for the given selector. If no element matches the selector, returns null. Discouraged: use locator-based frame.locator() instead.

This method queries the frame for all elements matching the given selector. Returns empty array if no elements match. Discouraged: use locator-based frame.locator() instead.

Discouraged: use locator-based locator.textContent() instead.

Discouraged: use locator-based locator.innerText() instead.

Discouraged: use locator-based locator.innerHTML() instead.

Discouraged: use locator-based locator.getAttribute() instead.

Throws for non-input elements. Discouraged: use locator-based locator.inputValue() instead.

Throws if the element is not a checkbox or radio input. Discouraged: use locator-based locator.isChecked() instead.

Discouraged: use locator-based locator.isDisabled() instead.

Discouraged: use locator-based locator.isEditable() instead.

Discouraged: use locator-based locator.isEnabled() instead.

Opposite of isVisible(). Discouraged: use locator-based locator.isHidden() instead.

Element is considered visible if it has non-zero bounding box and is not visibility:hidden. Discouraged: use locator-based locator.isVisible() instead.

Returns null if waiting for hidden or detached. Returns the ElementHandle matching the selector in visible/attached states. Discouraged: use locator-based locator.waitFor() instead.

Note: This should never be used in production. Tests that wait for time are inherently flaky. Use Locator actions and web assertions that wait automatically.

It resolves to a JSHandle of the truthy value. The function is called periodically. You can pass a polling interval.

Returns the return value of pageFunction. If the function returns a Promise, evaluate will wait for that Promise to resolve and return its value.

Returns a JSHandle for the in-page object. Unlike evaluate, this does not return the value of the function, but a handle pointing to the value.

Returns the value of pageFunction. Throws if selector matches no elements. Discouraged: use locator-based locator.evaluate() instead.

Returns the value of pageFunction. Discouraged: use locator-based locator.evaluateAll() instead.

Returns the ElementHandle for the <iframe> or <frame> tag for this frame. Returns null for the main frame.

If the name is empty, returns the id attribute instead. Returns empty string if both name and id are empty.

Returns the added tag when the script’s onload fires or when the script content was injected into frame.

Returns the added tag when the stylesheet’s onload fires or when the CSS content was injected into frame.