File: frames.md | Updated: 11/18/2025
On this page
Introduction
A Page
can have one or more Frame
objects attached to it. Each page has a main frame and page-level interactions (like click) are assumed to operate in the main frame.
A page can have additional frames attached with the iframe HTML tag. These frames can be accessed for interactions inside the frame.
// Locate element inside frameLocator username = page.frameLocator(".frame-class").getByLabel("User Name");username.fill("John");
Frame objects
One can access frame objects using the Page.frame() API:
// Get frame using the frame"s name attributeFrame frame = page.frame("frame-login");// Get frame using frame"s URLFrame frame = page.frameByUrl(Pattern.compile(".*domain.*"));// Interact with the frameframe.fill("#username-input", "John");